home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / qedit215.zip / QEDIT.DOC < prev    next >
Text File  |  1991-09-04  |  254KB  |  6,541 lines
  1.                                                                                                                                
  2.                         Welcome to
  3.  
  4.                     QEdit(R) Advanced
  5.                     the "quick editor"
  6.  
  7.                 Version 2.1 (February 1990)
  8. (See the file "READ.ME" for additional v2.15 documentation)
  9.  
  10.  
  11.              R E F E R E N C E   M A N U A L
  12.  
  13. Please note that this is the shareware version of the documentation.
  14. The licensed commercial version includes an indexed, bound manual.
  15.  
  16.  
  17.  
  18.                        SemWare(R)
  19.             4343 Shallowford Road, Suite C3A
  20.                 Marietta, GA  30062-5022
  21.  
  22.                  VOICE: (404)  641-9002
  23.                  FAX:   (404)  640-6213
  24.                  BBS:   (404)  641-8968
  25.  
  26. Copyright 1985-1991 Applied Systems Technologies, Inc.
  27. All rights reserved worldwide.
  28.  
  29. This software embodies valuable trade secrets proprietary to Applied
  30. Systems Technologies, Inc.
  31.  
  32. SemWare and QEdit are registered trademarks of Applied Systems
  33. Technologies, Inc.  All trademarks referenced in this document are
  34. the property of their respective owners.
  35.  
  36. Specifications subject to change without notice.
  37.  
  38.  
  39.          _______
  40.     ____|__     |                (R)
  41.  --|       |    |-------------------
  42.    |   ____|__  |  Association of
  43.    |  |       |_|  Shareware
  44.    |__|   o   |    Professionals
  45.  -----|   |   |---------------------
  46.       |___|___|    MEMBER
  47.  
  48. This program is produced by a member of the Association of Shareware 
  49. Professionals (ASP). ASP wants to make sure that the shareware 
  50. principle works for you. If you are unable to resolve a 
  51. shareware-related problem with an ASP member by contacting the 
  52. member directly, ASP may be able to help. The ASP Ombudsman can help 
  53. you resolve a dispute or problem with an ASP member, but does not 
  54. provide technical support for members' products. Please write to the 
  55. ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442- 9427 or send a 
  56. Compuserve message via CompuServe Mail to ASP Ombudsman 70007,3536.
  57.  
  58.  
  59.          QEDIT ADVANCED SHAREWARE SOFTWARE LICENSE
  60.          =========================================
  61.  
  62. This version of QEdit is NOT public domain or free software, but is
  63. being distributed as "shareware" for EVALUATION PURPOSES ONLY.
  64.  
  65. Copyright, Proprietary Rights
  66. -----------------------------
  67. The QEdit Advanced software is owned by Applied Systems
  68. Technologies, Inc. (doing business under the registered tradename
  69. SemWare) or its suppliers and is protected by United States
  70. copyright laws and international treaty provisions. You may not
  71. reverse engineer, decompile, disassemble, or create derivative works
  72. based on the software for any purpose other than creating an
  73. adaptation to the software as an essential step in its utilization
  74. for your own use. This software embodies valuable trade secrets
  75. proprietary to SemWare; you may not disclose any information
  76. regarding the internal operations of this software to others.
  77.  
  78. Usage Restrictions
  79. ------------------
  80. SemWare grants a limited license to individuals to use this 
  81. shareware software for a 30-day evaluation period on a private, 
  82. non-commercial basis, for the express purpose of determining whether 
  83. QEdit is suitable for their needs. At the end of this 30-day 
  84. evaluation period, the individual must either purchase a license 
  85. from SemWare for continued use of the program, or discontinue using 
  86. QEdit.
  87.  
  88. What does this mean? If you use this program on a continued basis, 
  89. you must purchase a license for its use. QEdit is NOT free, and we 
  90. are not giving away free copies. We are giving you the opportunity 
  91. to try it before paying for a license for continued use. It is that 
  92. simple. Try it. Then either pay for it, or quit using it.
  93.  
  94. Paying for a license to continue using the software product is not 
  95. only required, but also allows SemWare to provide support and 
  96. updates, and stay in business. Licensed users receive printed 
  97. documentation, additional utilities and configuration files, and a 
  98. version of the program that does NOT show the opening and closing 
  99. shareware reminder screens. Registration of the licensed copy allows 
  100. the registered user to receive free technical support (by phone, 
  101. fax, our own support BBS, mail, or various electronic services such 
  102. as CompuServe), and makes them eligible for discounts on future 
  103. versions.
  104.  
  105. Purchasing a license for QEdit Advanced entitles you to use the 
  106. program on any and all computers available to you, provided you do 
  107. not operate QEdit on more than one computer or terminal at a time 
  108. and you do not operate QEdit on a network or a multi-user system. If 
  109. you would like a network or multiple-use (site) license, please 
  110. contact SemWare for details.
  111.  
  112.  
  113. Distribution, Copying Restrictions
  114. ----------------------------------
  115. Individuals are granted a limited license to copy the SHAREWARE 
  116. version of QEdit Advanced only for the trial use of other 
  117. individuals and subject to the above limitations. This license DOES 
  118. NOT include distribution or copying of this software package:
  119.  
  120.    1.  In connection with any other product or service;
  121.  
  122.    2.  For general use within a company, institution, or agency;
  123.  
  124.    3.  For any consideration or 'disk fee'; or
  125.  
  126.    4.  In modified form (i.e., any distribution that does not
  127.        include ALL FILES supplied by SemWare with the shareware
  128.        version of QEdit Advanced, WITHOUT ALTERATION. This also
  129.        prohibits distribution of all or portions of the
  130.        documentation in printed form.)
  131.  
  132. Operators of electronic bulletin board systems (Sysops) are
  133. permitted and encouraged to post the shareware version of QEdit
  134. Advanced for downloading by their users, as long as the above
  135. conditions are met. Though a fee may be charged for BBS access, NO
  136. FEE may be charged to specifically access or download the QEdit
  137. Advanced shareware files.
  138.  
  139. Non-profit computer-related User Groups may distribute the shareware
  140. version of QEdit Advanced provided the above conditions are met.
  141. However, such User Groups MAY charge a NOMINAL fee to cover the cost
  142. of the disk and copying of the software.
  143.  
  144. Disk vendors MUST obtain written permission from SemWare before 
  145. distributing the shareware version of QEdit Advanced. Certain 
  146. restrictions apply. Generally, ASP approved vendors are granted 
  147. permission. For further details, see VENDOR.DOC.
  148.  
  149.  
  150.                     WARRANTY DISCLAIMER
  151.                     ===================
  152.  
  153. SEMWARE PROVIDES THE SHAREWARE VERSION OF QEDIT ADVANCED "AS IS" AND 
  154. WITHOUT ANY WARRANTY. TO THE EXTENT PERMITTED UNDER APPLICABLE LAW, 
  155. SEMWARE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT 
  156. NOT LIMITED TO, ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS 
  157. FOR A PARTICULAR PURPOSE. SPECIFICALLY, SEMWARE MAKES NO 
  158. REPRESENTATION OR WARRANTY THAT THE SOFTWARE IS FIT FOR ANY 
  159. PARTICULAR PURPOSE.
  160.  
  161. SEMWARE SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE USE 
  162. OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, LOSS OF PROFIT, DATA 
  163. OR USE OF THE SOFTWARE, OR SPECIAL, INCIDENTAL OR CONSEQUENTIAL 
  164. DAMAGES OR OTHER SIMILIAR CLAIMS, EVEN IF SEMWARE HAS BEEN 
  165. SPECIFICALLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES 
  166. DO NOT ALLOW THE EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, 
  167. SO THE FOREGOING LIMITATION MAY NOT APPLY TO YOU.
  168.  
  169.  
  170.  
  171.               US GOVERNMENT RESTRICTED RIGHTS
  172.               ===============================
  173.  
  174. This software and documentation are provided with RESTRICTED RIGHTS. 
  175. Use, duplication or disclosure by the U.S. Government is subject to 
  176. restrictions as set forth in subparagraph (c)(1)(ii) of the Rights
  177. in Technical Data and Computer Software clause at 252.227-7013. 
  178. Contractor/manufacturer is Applied Systems Technologies, Inc., 4343 
  179. Shallowford Road, Suite C3A, Marietta, Georgia 30062-5022, U.S.A.
  180.  
  181.  
  182.             ORDERING INFORMATION
  183.  
  184. Purchasing a license for QEdit Advanced allows you to use the 
  185. product on a regular and/or continuing basis. Registration of your
  186. licensed copy of QEdit Advanced entitles you to free technical 
  187. support from SemWare, discounts on updates, and access to the 
  188. Registered User area of our support BBS (404/641-8968, <N81>, 
  189. 1200/2400/9600 baud, 24 hours a day).
  190.  
  191. With your purchase, you will receive: a licensed copy of QEdit
  192. Advanced V2.15 with a 90-day limited warranty; a bound, indexed
  193. manual, along with a QEdit quick reference card; additional 
  194. utilities for use with QEdit.
  195.  
  196. We offer discounts to educational institutions, full-time students, 
  197. BBS sysops, US and Georgia government agencies, and various approved 
  198. Computer-related User Groups. Students must include proof of student 
  199. status (photocopy of current registration slip or student ID card). 
  200. BBS sysops must supply the name and number of their BBS, along with 
  201. any other relevant information. User Groups must be members of our 
  202. SemWare Supporter program. Call for details.
  203.  
  204. ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE.
  205.  
  206.  
  207. SITE LICENSES AND QUANTITY PURCHASES
  208. ------------------------------------
  209. All corporate, business, government or other commercial, public, or 
  210. private users of QEdit must be licensed. We offer quantity discounts 
  211. as well as site (multi-user) licensing. Please call or write for 
  212. more information.
  213.  
  214. ORDERS OUTSIDE THE U.S./CANADA/MEXICO
  215. -------------------------------------
  216. Please use your MasterCard, VISA, American Express, Carte Blanche,
  217. Diners Club, or Discover card when ordering, or send a check drawn
  218. on a US bank payable in US dollars. Please add $10 for each copy to
  219. cover overseas shipping.
  220.  
  221.  
  222. Remit to:  SemWare                                  Order Form  #9108-OF04
  223.            4343 Shallowford Rd, Suite C3A
  224.            Marietta, GA  30062-5022  USA
  225.  
  226.             ***  QEdit Advanced version 2.15, August 1991  ***
  227.                     * Single-User License Order Form *
  228.  
  229. We take VISA, MasterCard, American Express, Diners Club, Carte Blanche,
  230. and Discover. You can use this handy order form to order by MAIL, or by:
  231.  
  232.  PHONE: (404) 641-9002 (Mon-Fri, 9am-5pm ET)       FAX: (404) 640-6213
  233.            BBS: (404) 641-8968   (1200/2400/9600 HST, <N81>)
  234.                          COMPUSERVE:  71520,67
  235.  
  236. NOTE: We offer quantity discounts and multiple-user licenses. We also
  237.       offer student/educational discounts, discounts to BBS sysops, US and
  238.       Georgia govt. agencies, and approved User Groups. Call for details.
  239. --------------------------------------------------------------------------
  240. SemWare, send me:
  241.  
  242. ____ QEdit Advanced with Printed Manual.......... @ $54.95 ea  $ ______
  243.      Includes single-user licensed copy of software (Version
  244.      2.15) with 90-day limited warranty, spiral-bound
  245.      indexed manual, reference card, low-cost upgrades.
  246.  
  247. SHIPPING (each copy)... US/Canada/Mexico: $3;  Overseas: $10   $ ______
  248.  
  249. Purchase Orders under $100.00, add $6 Billing Fee ...........  $ ______
  250.      (DOES NOT APPLY to PREPAID Check or Charge Card orders)
  251.  
  252.                                                      SUBTOTAL  $ ______
  253.  
  254. Georgia Residents please add Sales Tax ................  @ 5%  $ ______
  255.  
  256.                          TOTAL (U.S. Funds drawn on U.S. Bank) $ ______
  257.                                              
  258. Payment by:  ( )CHECK   ( )VISA   ( )MC   ( )AMEX   ( )PO#_____________
  259.                      ( )DC     ( )CB   ( )DISCOVER      (copy attached)
  260.  
  261. Name: _____________________________________________________________
  262.  
  263. Company (ONLY if company address):_________________________________
  264.  
  265. Address: __________________________________________________________
  266.  
  267.        : __________________________________________________________
  268.  
  269.        : __________________________________________________________
  270.  
  271. Voice Day Phone: ______________________ Evening: __________________
  272.  
  273. Card #: _________________________________ Exp. Date: ______________
  274.  
  275. Signature of cardholder: __________________________________________
  276.  
  277. PRICES SUBJECT TO CHANGE WITHOUT NOTICE.  Call to confirm current prices.
  278.         TSR and OS/2 VERSIONS NOW AVAILABLE!  Call for details.
  279.  
  280.  
  281. TABLE OF CONTENTS________________________________________
  282.  
  283. Acknowledgements ...................................  ii
  284. Introduction ....................................... iii
  285. Features ...........................................  iv
  286. System Requirements ................................   v
  287. Installation .......................................  vi
  288.  
  289. Chapter 1  Users Guide for QEdit                     1-1
  290.    Quick Start ..................................... 1-2
  291.       Getting Started .............................. 1-2
  292.       In the Editor ................................ 1-2
  293.       Getting Out .................................. 1-3
  294.    Menus ........................................... 1-3
  295.    The Status Line ................................. 1-4
  296.    Files ........................................... 1-5
  297.       Creating New Files ........................... 1-5
  298.       Loading Existing Files ....................... 1-5
  299.       Multiple Files:  The Ring .................... 1-6
  300.       Saving Files and Exiting  .................... 1-8
  301.    Viewing and Getting Around in the Text .......... 1-9
  302.       Cursor Movement .............................. 1-9
  303.          Moving Through a File ..................... 1-9
  304.          Moving Around on the Screen ............... 1-12
  305.          Moving by Lines and Characters ............ 1-13
  306.       Using Windows ................................ 1-13
  307.          Creating Windows .......................... 1-14
  308.          Switching Windows ......................... 1-14
  309.          Changing Window Size ...................... 1-14
  310.          Closing Windows ........................... 1-15
  311.    Copying, Moving, Replacing, and Deleting text ... 1-16
  312.       Block Commands ............................... 1-16
  313.          Marking and Unmarking a Block ............. 1-16
  314.          Manipulating Blocks Directly .............. 1-18
  315.          Manipulating Blocks Using Scrap Buffers ... 1-19
  316.          Manipulating Blocks Using Scratch Buffers . 1-21
  317.          Examples of Block Commands ................ 1-22
  318.       Non-Block Commands ........................... 1-25
  319.          Adding Text ............................... 1-25
  320.          Copying Text .............................. 1-26
  321.          Moving Text ............................... 1-27
  322.          Deleting and Undeleting Text .............. 1-28
  323.          Replacing Text ............................ 1-29
  324.       The Kill Buffer - A Safety Net ............... 1-31
  325.    Macros .......................................... 1-33
  326.       Creating Macros .............................. 1-33
  327.  
  328.       Using Macros ................................. 1-34
  329.       Saving and Reloading Macros .................. 1-34
  330.       Example of a Macro ........................... 1-35
  331.    Printing ........................................ 1-35
  332.       Print Formatting ............................. 1-36
  333.       Formfeeds .................................... 1-36
  334.    The Shell and Dos Commands ...................... 1-37
  335.    Word Processing Commands ........................ 1-38
  336.    Modes ........................................... 1-39
  337.  
  338. Chapter 2  Customizing QEdit                         2-1
  339.    Initiating the Configuration Program ............ 2-2
  340.    The Configuration Menu .......................... 2-3
  341.    Advanced Options ................................ 2-5
  342.    Colors/Screen Options ........................... 2-7
  343.    General Options ................................. 2-9
  344.    The Help Screen ................................. 2-13
  345.    Keyboard Configuration .......................... 2-14
  346.       The Keyboard Definition File ................. 2-14
  347.       Creating a Keyboard Definition File .......... 2-16
  348.    Printer Options ................................. 2-17
  349.    Tab Settings .................................... 2-18
  350.  
  351. Chapter 3  QEdit Command Reference                   3-1
  352.  
  353. Appendix A.  List of Commands                        A-1
  354.    By Function ..................................... A-1
  355.    Alphabetically .................................. A-6
  356.  
  357. Appendix B.  List of Configurable Keys               B-1
  358.    Function Keys ................................... B-1
  359.    Special Purpose Keys ............................ B-2
  360.    Control Keys .................................... B-3
  361.    Alternate Keys .................................. B-5
  362.    Enhanced Keyboard Keys .......................... B-6
  363.  
  364. Appendix C.  Error Messages                          C-1
  365.    QEdit Error Messages ............................ C-1
  366.    QCONFIG Error Messages .......................... C-3
  367.  
  368. Appendix D.  Commonly Used Macros                    D-1
  369.  
  370. Appendix E.  Addendum                                E-1
  371.  
  372. ***NOTE:  Because of disk space limitations, the Index
  373.           has been omitted from this documentation.
  374.  
  375. ACKNOWLEDGEMENTS____________________________________________________
  376.  
  377. Many years of work have gone into the development of this version of
  378. QEdit.  And we had LOTS of help.  Special thanks go to:
  379.  
  380. My wife, for her many valuable suggestions, for "proofing" this
  381. manual, and for putting up with all the long hours (and many all
  382. nighters) that I have spent working on QEdit.
  383.  
  384. Gerhard Barth, who went above and beyond the call of duty to help us
  385. track down a nasty bug in the very first version of QEdit.
  386.  
  387. P.L. Olympia, who has gone out of his way and spent much time
  388. promoting this program.
  389.  
  390. Anthony M. Marcy, who developed the INLINER program, an assembler
  391. which translates 8088 assembly language directly into Turbo Pascal
  392. INLINE code.
  393.  
  394. Karl Brendel, for his constant support and excellent testing.  Karl
  395. is also the author of an excellent add-on product for QMODEM called
  396. QFONEDIT.
  397.  
  398. John Newlin, for his encouragement and support.  John is also the
  399. author of SCOUT.  If you're looking for a powerful file or DOS
  400. manager that's memory resident, then look no further.  SCOUT is
  401. probably what you're looking for.
  402.  
  403. Stuart Warren, for his insight, encouragement, and many valuable
  404. programming suggestions.
  405.  
  406. Steve Watkins, for all the many hours he spent testing and the many
  407. "hard to find" bugs and quirks that he uncovered.
  408.  
  409. All the folks at TurboPower software.  We're especially grateful for
  410. TdebugPlus.  Using Turbo Pascal without the tools provided by the
  411. TurboPower folks is just plain wasteful!
  412.  
  413. To ALL registered users - THANK YOU - it is only through your
  414. support that additional versions are made possible.
  415.  
  416.  ii
  417.  
  418. INTRODUCTION________________________________________________________
  419.  
  420. "You can never be too rich, too thin, or have too much RAM and
  421. Disk storage."  Ancient American proverb, ca. 1980
  422.  
  423. This manual describes the use and operation of QEdit, a full-screen
  424. text editor for the IBM PC and compatible computers.  The manual
  425. includes installation instructions, a user's guide, and a reference
  426. section which explains all of QEdit's commands.
  427.  
  428. QEdit is a text editor as opposed to a word processor.  This means
  429. that most of its features are geared toward creating and maintaining
  430. program source code and other text files.  However, QEdit can also
  431. be used like a word processor to write documents or letters since it
  432. includes word-wrapping and paragraph reformatting capabilities.
  433.  
  434.  
  435. QEdit was developed with these goals in mind:
  436.  
  437. - FAST OPERATION - More than anything else, QEdit was designed to
  438.   operate quickly, especially in these areas:
  439.  
  440.     - Initially loading a file for editing.
  441.     - Displaying/Updating the screen.
  442.     - Moving through the editing window.
  443.     - Searching for text.
  444.     - Saving a file back to disk.
  445.  
  446.  
  447. - EASE OF USE - This version of QEdit includes:
  448.  
  449.     - Optional "Pop-Down" menus.
  450.     - Customizable Help Screen.
  451.     - Complete execution from a single file (Q.EXE).
  452.     - Pop-up file directory and picker.
  453.  
  454.  
  455. - COMPACT PROGRAM SIZE - Every effort was made to keep the program
  456.   size as compact as possible.  Even though memory is getting
  457.   cheaper all the time, we didn't want QEdit to require any more
  458.   memory than absolutely necessary.
  459.  
  460.  iii
  461.  
  462. FEATURES____________________________________________________________
  463.  
  464. These are just some of the many features you will enjoy while using
  465. QEdit:
  466.  
  467. - It is very fast!
  468.  
  469. - It is customizable.  QEdit can be easily configured the way you
  470.   like it.  This includes the meaning of ALL special keys on the
  471.   keyboard (Alt, Ctrl, and function keys; <Home>, <PgUp>, etc.),
  472.   colors, screen appearance, and many other options.
  473.  
  474. - It utilizes all available memory.  With QEdit you can edit files
  475.   as large as your computer's memory will allow.
  476.  
  477. - It allows true multi-file editing.  The number of files you can
  478.   edit is limited only by available memory.
  479.  
  480. - It enables you to view files through up to eight "windows".  You
  481.   can have multiple views of the same file or view a different file
  482.   in each window.
  483.  
  484. - It provides up to 99 scratch buffers for cut-and-paste or template
  485.   operations.
  486.  
  487. - It allows you to exit to DOS (or a DOS shell) temporarily and use
  488.   DOS commands from within the editor.
  489.  
  490. - It is easy to use.  You can use the optional "Pop-Down" menus to
  491.   access QEdit's commands, and there is a Help Screen which you can
  492.   customize for your own needs.
  493.  
  494. - It supports Character, Line, and Column Blocks.
  495.  
  496. - It allows you to create macros which will execute a series of
  497.   commands and keystrokes by pressing a single key.
  498.  
  499. - It provides wordwrap and paragraph reformat capabilities.
  500.  
  501. - It saves deleted words, lines, and Blocks in a deletion buffer for
  502.   later recall.
  503.  
  504. - It provides "C mode", which utilizes automatic indentation for C
  505.   language programming.
  506.  
  507. - It locates matching braces and parentheses, a useful feature for
  508.   programming.
  509.  
  510. - It will load multiple files from the DOS command line, with or
  511.   without wildcard characters.
  512.  
  513. - It allows you to specify up to six default file extensions for use
  514.   when loading files and determining tab settings.
  515.  
  516.  iv
  517.  
  518. - It allows you to execute command line compilers from within QEdit,
  519.   using its macro capability.
  520.  
  521. - It provides line drawing to create diagrams and tables.
  522.  
  523. - It supports enhanced (101 key) keyboards.
  524.  
  525. - It supports up to 200-column and 100-line screens.
  526.  
  527. - It supports EGA 43-line mode and VGA 50-line mode.
  528.  
  529. - It is compact.  Even with all these features, QEdit requires less
  530.   than 50k of disk space.
  531.  
  532.  
  533.  
  534. SYSTEM REQUIREMENTS_________________________________________________
  535.  
  536. QEdit will run on the IBM PS/2, PC/AT, PC/XT, PC, PC/Jr, and on IBM
  537. compatible computers including the Compaq, NCR, Tandy, and WYSE
  538. PC's.  MINIMUM requirements are:
  539.  
  540. - 128 KB of memory (although QEdit can utilize up to 640 KB if it
  541.   is available).
  542.  
  543. - PC-DOS 2.0 or greater or MS-DOS 2.0 or greater.
  544.  
  545. - One diskette drive.
  546.  
  547. - Either a color or a monochrome monitor with 80-column display.
  548.  
  549. - 60 KB of disk space.
  550.  
  551. - Q.EXE, the editor program itself.  No other files are necessary for
  552.   operating QEdit.
  553.  
  554.  v
  555.  
  556. INSTALLATION________________________________________________________
  557.  
  558. Before installing QEdit, you should review the contents of the
  559. READ.ME file on your QEdit distribution diskette.  This file
  560. contains important information (usage information, new features,
  561. changes, etc.) that became available after this manual was printed.
  562. You should carefully review the READ.ME file before using QEdit.
  563.  
  564. The READ.ME file also contains a complete list of the files included
  565. on the distribution diskette.  A partial list is included here:
  566.  
  567. Q.EXE          QEdit.  No other files are necessary for proper
  568.                operation of QEdit.
  569.  
  570. QCONFIG.EXE    The QEdit configuration program.  This program
  571.                allows you to customize QEdit.
  572.  
  573. QCONFIG.DAT    The default QEdit Keyboard Definition file. Used
  574.                by QCONFIG.EXE.
  575.  
  576. QHELP.TXT      The default QEdit Help text.  Used by QCONFIG.EXE.
  577.  
  578.  
  579. QEdit is simple to install.  But first, be sure to make a backup
  580. copy of the distribution diskette.
  581.  
  582. Once you have made your backup copy, simply copy Q.EXE to the disk
  583. and/or subdirectory where you would like to use it.  If you are
  584. using a hard disk, then you probably want to put it somewhere that
  585. is accessible via the "path".  For example, on our system, we keep
  586. many of our executable programs in a subdirectory called TOOLS.
  587.  
  588. +---------------------------------+
  589. |QEdit Tip:                       |
  590. | Please note that one of the     |
  591. | MAJOR features of QEdit is      |
  592. | configurability.  You can       |
  593. | customize the colors, the keys, |
  594. | the on-screen appearance of the |
  595. | editor, and many other          |
  596. | functions.                      |
  597. |                                 |
  598. | By spending just a small amount |
  599. | of time reviewing Chapter 2 on  |
  600. | configuration, you can benefit  |
  601. | greatly through customizing the |
  602. | editor to your personal         |
  603. | preferences.                    |
  604. +---------------------------------+
  605.  
  606. If you will be customizing QEdit (Refer to Chapter 2 for complete
  607. information on customizing QEdit), then you may wish to create a
  608. special directory and copy the files Q.EXE, QCONFIG.EXE,
  609. QCONFIG.DAT, and QHELP.TXT to that directory.
  610.  
  611.  vi
  612.  
  613. CHAPTER 1.  USERS GUIDE FOR QEDIT___________________________________
  614.  
  615. Quick Start
  616. ===========
  617.  
  618. With QEdit you can edit any text file with a few simple commands.
  619. The next three sections briefly describe the quickest way possible
  620. to load, edit, and save a file.
  621.  
  622.  
  623. Getting Started
  624.  
  625. Using QEdit is simple and straightforward.
  626.  
  627. To initiate QEdit, type "Q <Enter>".  The Editor will respond with
  628. a prompt for the name of the file to be edited.
  629.  
  630. +-----------------------------------------------------+
  631. |  File(s) to edit: <Esc = abort>                     |
  632. |                                                     |
  633. +-----------------------------------------------------+
  634.  
  635. Enter the filename.  The filename may include full path designation.
  636.  
  637. +---------------------------------+
  638. |QEdit Tip:                       |
  639. |  At any "File to edit" prompt,  |
  640. |  you may use wildcard characters|
  641. |  (* or ?) to obtain a list of   |
  642. |  matching files in the          |
  643. |  directory.                     |
  644. +---------------------------------+
  645.  
  646. You may optionally include the filename on the DOS command line in
  647. order to bypass this prompt.  For example, from the DOS command line,
  648. type:
  649.                "Q filename <Enter>"
  650.  
  651.  
  652. In the Editor
  653.  
  654. Once you are in QEdit, the cursor movement keys (Left, Right, Up,
  655. Down, Home, End, ...) allow you to move around in the text.
  656.  
  657. To obtain a help screen, simply press <F1>.  Pressing <F1> again
  658. returns you to the text.
  659.  
  660. To obtain a menu of QEdit commands, press <Esc>.  You may then use
  661. the cursor movement keys to position the cursor bar over the desired
  662. command.  Pressing <Enter> will execute the command.
  663.  
  664.  1-2
  665.  
  666. +------------------------------------------------+
  667. | QEdit Tip:                                     |
  668. |   Pressing <Esc> will abort any editor prompt. |
  669. +------------------------------------------------+
  670.  
  671.  
  672. Getting Out
  673.  
  674. The easiest way to get out of QEdit and save all the work you have
  675. done is to enter <Alt F> <G>.
  676.  
  677.  
  678. Menus
  679. =====
  680.  
  681. QEdit provides an easy-to-use "Pop-Down" style menu system.  The
  682. menu system is very helpful while learning to use the editor.  It is
  683. also handy for executing seldom used commands.
  684.  
  685. To access the menus and execute a command:
  686.  
  687. 1.  Press <Esc>.  The main menu will be displayed at the top of
  688.     the screen.  The main menu consists of a list of sub-menu items.
  689.  
  690. 2.  Select a sub-menu item.  You may do this by moving the cursor 
  691.     bar to the desired item and pressing <Enter> or by typing the 
  692.     capital letter of the desired item.
  693.  
  694. 3.  Execute a command.  This is done in the same manner as selecting
  695.     the sub-menu items.
  696.  
  697. Here is an example of the "Pop-Down" style menu system.  This User
  698. is about to execute the "Copy block" command.
  699.  
  700. +----------------------------------------------------------------+
  701. |File  Window #Block# Search  Print  Macro  Editing  Other  Quit |
  702. +----------------------------------------------------------------+
  703.               | mark block Begin |
  704.               | mark block End   |
  705.               |#Copy block#######|
  706.               | Move block       |
  707.               | Delete block     |
  708.               | Unmark           |
  709.               | mark Line        |
  710.               +------------------+
  711.  
  712. You can execute many QEdit commands using the menus.  As you become
  713. more familiar with the editor, you may wish to use the <Ctrl>,
  714. <Alt>, and function keys, instead of the menus, to execute commands
  715. more quickly.  A cross reference of all QEdit commands can be found
  716. in Appendix A.
  717.  
  718.  1-3
  719.  
  720. The Status Line
  721. ===============
  722.  
  723. At the top of the editing screen is the Status Line.  The Status
  724. Line constantly displays information regarding the file you are
  725. currently editing.
  726.  
  727. The Status Line is shown below with a description of the information
  728. displayed.
  729.  
  730. +----------------------------------------------------------------+
  731. |L 15   C 15   IAW R B  411K   *c:\qedit\qedit.doc               |
  732. +----------------------------------------------------------------+
  733.    |      |    ||| | |   |     |      |
  734.    |      |    ||| | |   |     |      +--- The path and name of the
  735.    |      |    ||| | |   |     |            file you are editing
  736.    |      |    ||| | |   |     |
  737.    |      |    ||| | |   |     +- *) Indicates file has been changed
  738.    |      |    ||| | |   |
  739.    |      |    ||| | |   +--- Amount of available memory
  740.    |      |    ||| | |
  741.    |      |    ||| | +--- B) Indicates Box Drawing mode is ON
  742.    |      |    ||| |
  743.    |      |    ||| +--- R) Indicates macro recording is ON
  744.    |      |    |||
  745.    |      |    ||+--- W) Indicates WordWrap mode is ON
  746.    |      |    ||
  747.    |      |    |+--- A) Indicates AutoIndent mode is ON
  748.    |      |    |
  749.    |      |    +--- I) Indicates Insert mode is ON
  750.    |      |
  751.    |      +--- The current cursor column number
  752.    |
  753.    +--- The current cursor line number
  754.  
  755.  
  756. For more information on Insert, AutoIndent, WordWrap, and Box
  757. Drawing, refer to the "Modes" section in this chapter.  For more
  758. information on macro recording, refer to the "Macros" section in
  759. this chapter.
  760.  
  761. +---------------------------------+
  762. | QEdit Tip:                      |
  763. |   The Status Line may be config-|
  764. |   ured to appear at the bottom  |
  765. |   of the screen.  Refer to the  |
  766. |   "Colors/Screen Options"       |
  767. |   section of Chapter 2 for more |
  768. |   information.                  |
  769. +---------------------------------+
  770.  
  771.  1-4
  772.  
  773. Files
  774. =====
  775.  
  776. Creating New Files
  777.  
  778. There are three different ways to create new files, ready for 
  779. editing.
  780.  
  781. 1. From the DOS command line, enter <Q> followed by one or more new
  782.    filenames.  Each filename must be separated by a space. For
  783.    example, typing:
  784.  
  785.                "Q file1 b:file2 \dir1\file3 <Enter>"
  786.  
  787.    will create "file1" in the current directory, "file2" on disk
  788.    drive B, and "file3" in the directory "dir1".
  789.  
  790. +---------------------------------+
  791. | QEdit Tip:                      |
  792. |   When specifying file names    |
  793. |   to QEdit, you may use full    |
  794. |   path designations if desired. |
  795. +---------------------------------+
  796.  
  797. 2. From the DOS command line, type "Q <Enter>".  QEdit will
  798.    respond with the prompt:
  799.      +------------------------------------------------+
  800.      |  File(s) to edit: <Esc = abort>                |
  801.      |                                                |
  802.      +------------------------------------------------+
  803.  
  804.    Enter one or more new filenames, each separated by a space.
  805.  
  806. 3. From within the editor, enter the EditFile <Alt E> command. The
  807.    above prompt will appear.  Again, you may enter one or more new
  808.    filenames, each separated by a space.
  809.  
  810.  
  811. Loading Existing Files
  812.  
  813. Loading existing files works exactly like creating new files (in the
  814. previous section) with two exceptions:
  815.  
  816. - The filename(s) specified must exist on disk.
  817.  
  818. - The filename(s) may contain wildcard characters (*, ?).
  819.  
  820. QEdit can be configured to respond to wildcarded filename entries in
  821. one of two ways:
  822.  
  823. 1. Load all matching files into the editor.
  824.  
  825.  1-5
  826.  
  827. 2. Show all the matching filenames in a "pick" listing. You can then
  828.    use the cursor keys to find the file you want and press <Enter>
  829.    to load it into the editor.
  830.  
  831. QEdit can also be configured to use default file extensions, such as
  832. "doc" and "pas" when entering filenames.  For more information on
  833. configuring these options, refer to the "General Options" section of
  834. Chapter 2.
  835.  
  836.  
  837. Multiple Files: The Ring
  838.  
  839. QEdit is a true multi-file editor.  It allows as many files as will
  840. fit into memory to be loaded at the same time.  All of these files
  841. can then be edited by simply switching back and forth between them
  842. without having to save and load each file individually. Switching
  843. between files is accomplished very quickly and easily.
  844.  
  845. A simple explanation of how QEdit handles multiple files will help
  846. you in manipulating and editing multiple files.
  847.  
  848. QEdit maintains all loaded files in a "ring".  As we describe each
  849. of the commands used to manipulate the files in the ring, refer to
  850. the illustration below.
  851.  
  852. +----------------------------------------------------+
  853. |             +----+              +----+             |
  854. |             |    |              |....|             |
  855. |     +-----> | A  | <---<Ctrl KP>|.B..|<Alt N>      |
  856. |     |       |    |              |....|      |      |
  857. |     |       +----+              +----+      |      |
  858. |     v         ^                 <Alt E>     v      |
  859. |   +----+      |                   |       +----+   |
  860. |   |    |      |                   |       |    |   |
  861. |   | F  | <----+-------------------+-----> | C  |   |
  862. |   |    |      |                   |       |    |   |
  863. |   +----+      |                   |       +----+   |
  864. |     ^         v                   v         ^      |
  865. |     |       +----+              +----+      |      |
  866. |     |       |    |              |    |      |      |
  867. |     +-----> | E  | <----------> | D  | <----+      |
  868. |             |    |              |    |             |
  869. |             +----+              +----+             |
  870. |                                                    |
  871. |                     The "Ring"                     |
  872. +----------------------------------------------------+
  873.  
  874. In the ring we see that six files have been loaded into the editor.
  875. You can, of course, load many more files - as many as your
  876. computer's memory will allow.
  877.  
  878.  1-6
  879.  
  880. Assume the file currently being edited is file "B".  You may then
  881. move from one file to another in any of the following ways:
  882.  
  883. - Enter the NextFile <Alt N> command.
  884.   You will now be editing the next file in the ring, file "C".
  885.  
  886. - Enter the PrevFile <Ctrl KP> command.
  887.   You will now be editing the previous file in the ring, file "A".
  888.  
  889. - Enter the EditFile <Alt E> command.
  890.   The editor will prompt for a filename.  You may enter the name of
  891.   any file in the ring.  The editor will make the entered file the
  892.   current one for editing.
  893.  
  894. You may, at any time, add files to the ring or discard files from
  895. the ring.  If you add a new file to the ring using the EditFile
  896. command, it will become the current file and the old current file
  897. will become the previous file.  If you delete a file from the ring
  898. the previous file will become the current file.
  899.  
  900. +---------------------------------+
  901. | QEdit Tip:                      |
  902. |   When loading files, be aware  |
  903. |   that QEdit will not load two  |
  904. |   copies of the same file.  If  |
  905. |   you issue the EditFile command|
  906. |   for a file already loaded,    |
  907. |   that file will become the     |
  908. |   new current file.             |
  909. +---------------------------------+
  910.  
  911.  1-7
  912.  
  913. Saving Files and Exiting
  914.  
  915. QEdit provides several different ways to save files, discard files,
  916. and exit the editor.  A set of five basic commands provides assorted
  917. combinations of saving, discarding, and exiting in order to suit
  918. individual preferences.
  919.  
  920. We recommend selecting one or two methods with which you feel most
  921. comfortable and using them consistently.
  922.  
  923. The table below summarizes these commands and their effects.
  924.  
  925. +------------------------------------------------------------------+
  926. |Command for Single    Command for Multiple                        |
  927. |File or Current File  Files                                       |
  928. |--------------------  --------------------                        |
  929. |Exit      <Ctrl KD>   GExit     <Alt X>           X       X   X(a)|
  930. |                                                                  |
  931. |File      <Ctrl KX>   GFile     <Alt F><G>    X           X   X(a)|
  932. |                                                                  |
  933. |PQuit     <Ctrl KQ>   GPQuit    <Alt Q><Q>            X   X   X(a)|
  934. |                                                                  |
  935. |Quit (b)                                                  X   X   |
  936. |                                                                  |
  937. |SaveFile  <Ctrl KS>   GSave     <Alt Y>       X                   |
  938. |                                                                  |
  939. |                                              |   |   |   |   |   |
  940. |  Edited File(s) are Saved Unconditionally ---+   |   |   |   |   |
  941. |                                                  |   |   |   |   |
  942. |     User Prompted to Save Edited Files (Y/N)  ---+   |   |   |   |
  943. |                                                      |   |   |   |
  944. |        User Warned That File Changes May Be Lost  ---+   |   |   |
  945. |                                                          |   |   |
  946. |                    File(s) are Discarded From Editor  ---+   |   |
  947. |                                                              |   |
  948. |                                 The Editor is Terminated  ---+   |
  949. |                                                                  |
  950. |    (a) The Exit, File, and PQuit commands can be configured to   |
  951. |        terminate or not terminate the editor.  Refer to the      |
  952. |        "General Options" section of Chapter 2 for more           |
  953. |        information.                                              |
  954. |                                                                  |
  955. |    (b) USE WITH CAUTION!                                         |
  956. +------------------------------------------------------------------+
  957.  1-8
  958.  
  959. Viewing and Getting Around in the Text
  960. ======================================
  961.  
  962. QEdit is quite versatile in allowing you to move around in the text.
  963. With simple keystrokes you can either move a few characters or lines
  964. at a time or move from one end of the file to another.  You can go
  965. to specific lines in the file or go to each occurrence of a
  966. particular string of characters.  And with QEdit's windows, you can
  967. view up to eight files at a time or have multiple views of the same
  968. file.
  969.  
  970. As you will see, there are quite a few commands in QEdit for moving
  971. around in your text.  If you are not already familiar with these
  972. types of commands, try them out.  You will probably find some new
  973. commands that will be useful for your applications of QEdit.
  974.  
  975.  
  976. Cursor Movement
  977. ---------------
  978.  
  979. Moving Through a File
  980.  
  981. QEdit provides several commands which enable you to move about in a
  982. file.
  983.  
  984. - BegFile <Ctrl PgUp> and EndFile <Ctrl PgDn>
  985.   As their names imply, these commands move the cursor to the
  986.   beginning or end of the current file.  BegFile positions the
  987.   cursor at column one on the first line of the file.  EndFile
  988.   positions the cursor after the last non-blank character on the
  989.   last line of the file.
  990.  
  991. - PageUp <PgUp> and PageDown <PgDn>
  992.   PageUp scrolls the text toward the top of the file, one page-full,
  993.   less one line, at a time.  PageDown scrolls the text toward the
  994.   end of the file, one page-full, less one line, at a time.
  995.  
  996. - HalfPgUp and HalfPgDn
  997.   These commands work exactly like the PageUp and PageDown commands,
  998.   except that they scroll only one-half page at a time.
  999.  
  1000. +---------------------------------+
  1001. | QEdit Tip:                      |
  1002. |   All QEdit commands, including |
  1003. |   those without default key     |
  1004. |   assignments, can be assigned  |
  1005. |   as the user desires, to       |
  1006. |   almost any key.  Refer to     |
  1007. |   the "Keyboard Configuration"  |
  1008. |   section of Chapter 2 for more |
  1009. |   information.                  |
  1010. +---------------------------------+
  1011.  
  1012.  1-9
  1013.  
  1014. - ScrollUp <Ctrl W> and LineUp
  1015.   These commands scroll the text one line at a time toward the 
  1016.   beginning of the file.
  1017.  
  1018.   The ScrollUp command will cause the cursor to remain on the same 
  1019.   line of text until it reaches the bottom of the screen, while the 
  1020.   LineUp command will cause the cursor to remain stationary on the 
  1021.   screen.
  1022.  
  1023. - ScrollDown <Ctrl Z> and LineDown
  1024.   These commands scroll the text one line at a time toward the end 
  1025.   of the file.
  1026.  
  1027.   The ScrollDown command will cause the cursor to remain on the same 
  1028.   line of text until it reaches the top of the screen, while the 
  1029.   LineDown command will cause the cursor to remain stationary on the 
  1030.   screen.
  1031.  
  1032. - GotoLine <Ctrl J>
  1033.   Upon entering the GotoLine command, QEdit will prompt with:
  1034.     +--------------------------+
  1035.     |line number: <Esc = abort>|
  1036.     |                          |
  1037.     +--------------------------+
  1038.  
  1039.   By typing a line number and <Enter>, QEdit will "jump" the cursor 
  1040.   to the specified line number.  An easy way to move about quickly 
  1041.   in your text is to keep track of critical positions by noting 
  1042.   their line number, which is displayed on the Status Line, and then 
  1043.   using this command to "jump" to those positions.
  1044.  
  1045. - GotoBlockBeg <Ctrl QB> and GotoBlockEnd <Ctrl QK>
  1046.   These commands move the cursor to the beginning or to the end of 
  1047.   the currently marked Block.  If the marked Block is in another 
  1048.   file, QEdit will make that file the current file and then move you 
  1049.   to the beginning or end of the Block.  For more information on 
  1050.   using marked Blocks, refer to the "Block Commands" section in this 
  1051.   chapter.
  1052.  
  1053. - PrevPosition <Ctrl QP>
  1054.   This command can come in very handy.  It moves you to the cursor's 
  1055.   previous position.  Although it would not be of much use if you 
  1056.   had only moved a character or two, it can be useful for larger 
  1057.   jumps of the cursor.
  1058.  
  1059.   For example, perhaps you are in the middle of a file and want to 
  1060.   check something at the very beginning of the file.  To get to the 
  1061.   beginning, you would simply enter BegFile <Ctrl PageUp>.  After 
  1062.   you look at the beginning, you want to get back to where you were 
  1063.   previously.  You could use PageDown, but that could be tedious, 
  1064.   especially if your file is large.  The easiest way would be to 
  1065.   enter PrevPosition, and with a single keystroke, you are 
  1066.   immediately back where you started.  Note: PrevPosition can only 
  1067.   take you back to the cursor's immediately previous position.
  1068.  
  1069.  1-10
  1070.  
  1071.   If there are intervening keystrokes that move the cursor,
  1072.   PrevPosition will move you back to the most recent location of the
  1073.   cursor.
  1074.  
  1075. - Find <Ctrl QF> and RepeatFind <Ctrl L>
  1076.   These commands will search for a specific string of characters in
  1077.   the file.  Upon entering the Find command, QEdit will prompt for
  1078.   the string of characters for which to search.
  1079.     +---------------------------------------------+
  1080.     |Search for: <Esc = Abort>                    |
  1081.     |                                             |
  1082.     +---------------------------------------------+
  1083.  
  1084.   Enter the desired string of characters and press <Enter>.
  1085.  
  1086.   QEdit will then prompt for the search options to use.
  1087.     +-------------------------------------------------------------+
  1088.     |Options [BGLIW] (Back Global Local Ignore-case Whole-words): |
  1089.     |I                                                            |
  1090.     +-------------------------------------------------------------+
  1091.  
  1092.   Enter the letter(s) corresponding to the option(s) you want and
  1093.   press <Enter>.  The available options are (see Appendix E for
  1094.   additional options):
  1095.  
  1096.     [B] = Search backward from the current cursor position. When you 
  1097.           choose "B", QEdit will search backward from the cursor 
  1098.           position toward the beginning of the file.  Otherwise, it 
  1099.           will search from the cursor position toward the end of the 
  1100.           file.
  1101.  
  1102.     [I] = Ignore the case (capital or lowercase) of the search 
  1103.           string.  For example, "Hello" would match "hello" if this 
  1104.           option is chosen.  This option is set ON by default.
  1105.  
  1106.     [W] = Search for whole words only. For example, when this option 
  1107.           is chosen, the word "sent" will match only the actual word 
  1108.           "sent".  Otherwise, any other words that contain the 
  1109.           string (such as "sentence" or "absent") would also match.
  1110.  
  1111.   Once the Find command is executed the cursor will be placed at the 
  1112.   first occurrence of the search string found in the text.  To 
  1113.   locate subsequent occurrences of the search string, simply enter 
  1114.   the RepeatFind command.
  1115.  
  1116.   If you want to search for a string and replace it with another 
  1117.   string, refer to the "Replacing Text" section in this chapter.
  1118.  
  1119. - Match <Alt F3>
  1120.   This is a specialized search command.  It acts only on the
  1121.   characters ( ), { }, and [ ].  With the cursor placed on one of
  1122.   these characters, enter the Match command.  QEdit will locate the 
  1123.   logical matching character of the pair.  This command can be 
  1124.   useful for programming in languages where complicated expressions 
  1125.   are grouped using these characters.
  1126.  1-11
  1127.  
  1128. Moving Around on the Screen
  1129.  
  1130. These commands affect the cursor position within the current
  1131. screen of displayed text.
  1132.  
  1133. - BegScreen <Ctrl Home> and EndScreen <Ctrl End>
  1134.   These commands move you to the first or last line of the screen
  1135.   (or current window if you have windows open).  The cursor's column
  1136.   position does not change.
  1137.  
  1138. - BegLine <Home> and EndLine <End>
  1139.   You are probably already familiar with these commands.  BegLine
  1140.   moves the cursor to the beginning, or column one, of the current
  1141.   cursor line. EndLine moves the cursor to the last non-blank
  1142.   character of the current cursor line.
  1143.  
  1144. - ScreenLeft <Alt F5> and ScreenRight <Alt F6>
  1145.   These commands scroll the entire text to the left or right one
  1146.   column at a time.  You can change the number of columns which are
  1147.   shifted each time using the QEdit configuration program.  Refer to
  1148.   the "Colors/Screen Options" section of Chapter 2 for more
  1149.   information.
  1150.  
  1151. - WordLeft <Ctrl Cursor Left> and WordRight <Ctrl Cursor Right>
  1152.   These commands move the cursor to the first character of the
  1153.   previous or following word in the text.
  1154.  
  1155. - MakeCtrofScreen <Shift F5>, MakeTopofScreen <F5>, MakeBotofScreen
  1156.   These three commands change the position of the cursor line on the 
  1157.   screen (or window, if you have windows open).  They can be useful 
  1158.   if you prefer to work at the bottom or top of the screen or if you 
  1159.   want to keep the text surrounding your cursor line in view.
  1160.  
  1161.   The MakeCtrofScreen command scrolls the text on the screen (either
  1162.   up or down) until the cursor line is the center line of the
  1163.   screen.
  1164.  
  1165.   The MakeTopofScreen command scrolls the text upward until the
  1166.   cursor line is the top line of the screen.
  1167.  
  1168.   The MakeBotofScreen command scrolls the text downward until the
  1169.   cursor line is the last line of the screen.
  1170.  
  1171.  1-12
  1172.  
  1173. Moving By Lines and Characters
  1174.  
  1175. These commands enable you to move in short increments through the
  1176. text.
  1177.  
  1178. - CursorLeft <Cursor Left> and CursorRight <Cursor Right>
  1179.   These commands move the cursor one column to the right or left on
  1180.   the cursor line.
  1181.  
  1182.   When you use CursorLeft, the cursor will stop when it reaches the
  1183.   left edge of the screen, unless the text has been scrolled to the
  1184.   left.  In that case it scrolls the text to the right one column at
  1185.   a time until it reaches column one.
  1186.  
  1187.   When you use CursorRight and the cursor reaches the right edge of
  1188.   the screen, it will begin to scroll the text to the left.  It will
  1189.   stop scrolling when it reaches the maximum line length.
  1190.  
  1191. - CursorUp <Cursor Up> and CursorDown <Cursor Down>
  1192.   These commands move the cursor up or down in the file one line at
  1193.   a time.  The cursor's column position does not change.
  1194.  
  1195. Using Windows
  1196. -------------
  1197.  
  1198. QEdit provides the ability to view different areas of files (either
  1199. multiple files or the same file) at the same time, through the use
  1200. of windows.  A window is a portion of the screen that allows you to
  1201. view text.  You can divide your screen into as many as eight
  1202. horizontal windows.  You can then view as many as eight different
  1203. files through these windows or have multiple views of a single
  1204. file. This capability can be quite helpful for comparing text,
  1205. copying text, and moving text.
  1206.  
  1207. An example of a screen split into three windows is shown below.
  1208. +------------------------------------------------------------+
  1209. | L 1    C 1    IAW         411K     *c:\file1               |
  1210. |                                                            |
  1211. | This window is a view of file number 1 at line number 1.   |
  1212. | This file is being edited with Insert, AutoIndent, and     |
  1213. | WordWrap modes all ON.  This file has been updated.        |
  1214. |                                                            |
  1215. |                                                            |
  1216. | L 483  C 12   IAW         411K     *c:\file1               |
  1217. |                                                            |
  1218. | This window is a view of file number 1 at line number 483. |
  1219. |                                                            |
  1220. |                                                            |
  1221. | L 15   C 15   I           411K      c:\file2               |
  1222. |               -                                            |
  1223. | This window is a view of file number 2.                    |
  1224. | This file is being edited with Insert mode ON, while       |
  1225. | AutoIndent and WordWrap modes are OFF.  This file has not  |
  1226. | been updated.                                              |
  1227. +------------------------------------------------------------+
  1228.  1-13
  1229.  
  1230. Creating Windows
  1231.  
  1232. To create a window, use the HorizontalWindow <Ctrl OH> command. The
  1233. screen will be split into two halves, or windows, each window having
  1234. its own Status Line.  The cursor will reside in the newly created
  1235. window, making it the current window.
  1236.  
  1237. If only one file is being edited, the newly created window will
  1238. simply be an additional view of the same file.  QEdit will not load
  1239. more than one copy of the same file.
  1240.  
  1241. If multiple files are being edited, the newly created window will be
  1242. a view of the next file in the ring.  (Refer to the "Multiple Files"
  1243. section in this chapter.)  If desired, you can configure QEdit to
  1244. prompt for the name of the file to be viewed in the new window
  1245. instead of the editor automatically selecting the next file in the
  1246. ring.  Refer to the "General Options" section of Chapter 2 for more
  1247. information.
  1248.  
  1249. Once the screen has been split into windows, entering the
  1250. HorizontalWindow command again will affect the current window. All
  1251. other windows will remain unchanged.
  1252.  
  1253.  
  1254. Switching Windows
  1255.  
  1256. When multiple windows are opened, editing will only take place in
  1257. the current window (the window containing the cursor).  For editing
  1258. text in other windows, two commands are provided to switch from one
  1259. window to another.
  1260.  
  1261. - The PrevWindow <Ctrl OP> command will move the cursor to the
  1262.   window above the current window.  If the current window is at the
  1263.   top of the screen, the cursor will move to the last window on the
  1264.   screen.
  1265.  
  1266. - The NextWindow <Ctrl ON> command will move the cursor to the
  1267.   window below the current window.  If the current window is at the
  1268.   bottom of the screen, the cursor will move to the first window on
  1269.   the screen.
  1270.  
  1271.  
  1272. Changing Window Size
  1273.  
  1274. You can change the size of any of the windows on the screen with the
  1275. commands below.
  1276.  
  1277. - The GrowWindow <Ctrl OG>, ShrinkWindow <Ctrl OS>, and ResizeWindow 
  1278.   <Esc><W><R>, commands allow you to change the size of the current 
  1279.   window.  Upon entering any of these commands, QEdit will prompt 
  1280.   you to change the size of the window by using the cursor up and 
  1281.   cursor down keys.
  1282.  
  1283.  1-14
  1284.  
  1285. - The ZoomWindow <Ctrl OZ> command will cause the current window to
  1286.   fill the entire screen, as all other windows disappear.  To
  1287.   restore the screen with all windows, simply press <Ctrl OZ> again.
  1288.   Be careful not to confuse this command with the OneWindow command
  1289.   (see below).  OneWindow fills the screen with the current window
  1290.   (like ZoomWindow does), but it also closes all windows except the
  1291.   current one.  ZoomWindow leaves the other windows intact, even
  1292.   though they are hidden from view.
  1293.  
  1294.  
  1295. Closing Windows
  1296.  
  1297. There are two commands to close windows.
  1298.  
  1299. - The CloseWindow <Ctrl OC> command closes the current window.  The
  1300.   current window will disappear and the cursor will be placed in the
  1301.   window above the closed window, making it the new current window.
  1302.   When the closed window is at the top of the screen, the window
  1303.   below the closed window will become the new current window.
  1304.  
  1305. - The OneWindow <Ctrl OO> command closes all windows except the
  1306.   current window.  The current window will fill the entire screen.
  1307.  
  1308. Note that closing a window does not discard files from the
  1309. editor.
  1310.  
  1311.  1-15
  1312.  
  1313. Copying, Moving, Replacing, and Deleting Text
  1314. =============================================
  1315.  
  1316.  
  1317. Block Commands
  1318. --------------
  1319.  
  1320. In this section, we will see how to mark and manipulate Blocks.  A
  1321. Block is some portion of the text file which has been specifically
  1322. delineated using QEdit's Block marking commands.  We will see how to
  1323. manipulate Blocks both directly and through the use of intermediate
  1324. storage areas known as buffers.
  1325.  
  1326. QEdit contains a rich set of Block commands.  There are commands to
  1327. mark Blocks by lines, columns, and characters.  There are commands
  1328. to copy, move, shift, and delete Blocks.  These commands are very
  1329. useful for transferring text from one file to another. There are
  1330. also cut-and-paste commands, as well as commands to move Blocks to
  1331. and from named Scratch Buffers.
  1332.  
  1333.  
  1334. Marking and Unmarking a Block
  1335.  
  1336. Before you can manipulate a Block, you must first "mark" or outline
  1337. a Block.  There are four ways of marking a Block in QEdit.  The one
  1338. you choose will depend on the editing situation and what you find
  1339. most comfortable to use.
  1340.  
  1341. - MarkLine <Alt L>
  1342.   This command allows you to mark a Block in whole line increments.
  1343.   In other words, the Block will contain complete lines only and no
  1344.   portions of lines.  To use this command place the cursor anywhere
  1345.   on the first line of the text you wish to mark and press <Alt L>.
  1346.   (Notice that the line is immediately marked.)  Now, move the
  1347.   cursor (the Block will "follow" the cursor) to the last line of
  1348.   text to be marked and press <Alt L> again.  You now have a marked
  1349.   Block, ready for manipulation.
  1350.  
  1351.  
  1352. - DropAnchor <Alt A>
  1353.   This command allows you to mark a Block one character at a time.
  1354.   In other words, the Block will contain a stream of characters
  1355.   (which can span over multiple lines).  To use this command place
  1356.   the cursor over the first character of the text you wish to mark
  1357.   and press <Alt A>.  Then begin moving the cursor toward the end of
  1358.   the text to be marked.  Notice that the Block "follows" the cursor
  1359.   position.  Once the cursor is placed over the last character to be
  1360.   marked, press <Alt A> again.  You now have a marked Block, ready
  1361.   for manipulation.
  1362.  
  1363.  1-16
  1364.  
  1365. - MarkCharacter
  1366.   This command works just like DropAnchor except that while marking
  1367.   the Block, the cursor is not included within the Block.
  1368.  
  1369.   MarkCharacter is provided as a replacement for the DropAnchor
  1370.   command.  If you want the cursor position included in character
  1371.   Blocks, then continue to use DropAnchor; otherwise, replace the
  1372.   DropAnchor command with this command in the QCONFIG.DAT file.
  1373.   Refer to the "Keyboard Configuration" section of Chapter 2 for
  1374.   more information on changing QEdit command assignments.
  1375.  
  1376. - MarkColumn <Alt K>
  1377.   This command allows you to mark one or more columns of text.  To
  1378.   use this command place the cursor over the upper left-hand
  1379.   character of the text you wish to mark and press <Alt K>.  Then
  1380.   begin moving the cursor to the right and/or downward.  Notice that
  1381.   the Block "follows" the cursor position.  Once the cursor is
  1382.   placed over the lower right-hand character of the Block, press
  1383.   <Alt K> again.  You now have a marked Block, ready for
  1384.   manipulation.
  1385.  
  1386. +--------------------------------------------------+
  1387. | QEdit Tip:                                       |
  1388. |   When using the MarkLine, MarkCharacter,        |
  1389. |   MarkColumn, and DropAnchor commands, it is not |
  1390. |   necessary to mark the end of the Block.  QEdit |
  1391. |   will assume the end of the Block to be the     |
  1392. |   current cursor position for DropAnchor,        |
  1393. |   MarkCharacter, and MarkColumn and the current  |
  1394. |   cursor line for MarkLine. Marking the end of   |
  1395. |   the Block is only necessary when moving or     |
  1396. |   copying text within the same file.             |
  1397. +--------------------------------------------------+
  1398.  
  1399. - MarkBlockBegin <Ctrl KB> and MarkBlockEnd <Ctrl KK>
  1400.   This is another method of marking a Block one character at a time.
  1401.   To mark a Block with this command, place the cursor over the first
  1402.   character of the text you wish to mark and press <Ctrl KB>.  Then
  1403.   position the cursor one character past the end of the text that is
  1404.   to be marked and press <Ctrl KK>.  The Block is now marked and
  1405.   ready for manipulation.
  1406.  
  1407. - UnmarkBlock <Alt U>
  1408.   Entering the UnmarkBlock command causes the currently marked Block
  1409.   to be unmarked.
  1410.  
  1411. QEdit allows you to mark one Block at a time.  If you mark a Block
  1412. and then go elsewhere in the file and attempt to mark another Block,
  1413. QEdit will simply extend the first Block by including all the text
  1414. between the original Block and the current cursor position.  If you
  1415. mark a Block in one file and then go to another file and mark a
  1416. Block, QEdit will automatically unmark the Block in the first file.
  1417.  
  1418.  1-17
  1419.  
  1420. Also, if you mix types of Block marking, by entering MarkLine
  1421. followed by DropAnchor or vice-versa, QEdit will mark the Block
  1422. according to the last command entered.
  1423.  
  1424. Manipulating Blocks Directly
  1425.  
  1426. QEdit provides several ways to manipulate a marked Block. The
  1427. following commands act directly on a marked Block.
  1428. +--------------------------------------------------+
  1429. | QEdit Tip:                                       |
  1430. |   When Copying or Moving Blocks:                 |
  1431. |                                                  |
  1432. |   Blocks marked using the Drop- Anchor,          |
  1433. |   MarkCharacter, MarkColumn, and                 |
  1434. |   MarkBlockBegin/End commands will always be     |
  1435. |   inserted beginning at the current cursor       |
  1436. |   position.                                      |
  1437. |                                                  |
  1438. |   Blocks marked using the Mark- Line command     |
  1439. |   will be inserted at either the line before or  |
  1440. |   the line after the current cursor line.  Refer |
  1441. |   to the "General Options" section of Chapter 2  |
  1442. |   for more information.                          |
  1443. +--------------------------------------------------+
  1444.  
  1445. - CopyBlock <Alt C>
  1446.   This command makes a copy of the marked Block and inserts it where
  1447.   you decide.  You can insert this copy of the Block at some other
  1448.   place in the same file or in another file.  The original Block of
  1449.   text, from which you made the copy, is not affected.
  1450.  
  1451.   To use this command, first mark the Block as described above.
  1452.   Next, move the cursor to the position in the file where you wish
  1453.   to insert the marked text.  (Or, if you have multiple files loaded
  1454.   and wish to copy text from one file to another, use the NextFile,
  1455.   PrevFile or EditFile commands to get a new current file and
  1456.   likewise position the cursor.)  Now enter the CopyBlock <Alt C>
  1457.   command.  The Block will be inserted at the new position.  You may
  1458.   notice, after you use CopyBlock, that the newly inserted Block of
  1459.   text is now marked and the original Block is unmarked.  To unmark
  1460.   the copied Block, enter the UnmarkBlock command.
  1461.  
  1462.   QEdit provides an easy method for copying the same Block
  1463.   repeatedly. Refer to the Copy and Paste commands in the following
  1464.   section for more information.
  1465.  
  1466. - CopyOverBlock <Alt Z>
  1467.   This command is for use with column Blocks only.  It works just
  1468.   like CopyBlock except the Block is copied to the current cursor
  1469.   position by overlaying existing text and without shifting text to
  1470.   the right.
  1471.  1-18
  1472.  
  1473. - MoveBlock <Alt M>
  1474.   This command works exactly like CopyBlock with one exception: Upon
  1475.   entering the MoveBlock <Alt M> command, the originally marked
  1476.   Block is deleted from the file.
  1477.  
  1478.   As with the CopyBlock command, you can move a Block to another
  1479.   part of the same file or from one file to another.
  1480.  
  1481.   QEdit provides an easy method for deleting a Block from its
  1482.   original position and inserting it repeatedly at other positions.
  1483.   Refer to the Cut and Paste commands in the following section for
  1484.   more information.
  1485.  
  1486. - DeleteBlock <Alt G>.
  1487.   This command simply deletes a marked Block of text from the file.
  1488.   To use this command, first mark a Block of text to be deleted,
  1489.   then enter the DeleteBlock command.  The marked text will be
  1490.   deleted from the file.  (Deleted Blocks will be placed in the Kill
  1491.   buffer. Refer to "The Kill Buffer" section in this chapter for
  1492.   more information.)
  1493.  
  1494. - ShiftLeft <Shift F7> and ShiftRight <Shift F8>
  1495.   These commands allow the User to shift text contained in a Block
  1496.   to the left or right. To use these commands, first mark a Block.
  1497.   Now enter ShiftLeft or ShiftRight.  The entire marked Block of
  1498.   text will be shifted one column to the left or right respectively.
  1499.   If there is no marked Block of text or the cursor is outside of
  1500.   the marked Block, the current cursor line will be shifted. This
  1501.   command is very useful for changing indentation for portions of
  1502.   text or source code.
  1503.  
  1504.  
  1505. Manipulating Blocks Using Scrap Buffers
  1506.  
  1507. QEdit provides an extremely helpful device for quickly manipulating
  1508. Blocks of text.  This device consists of a Scrap Buffer and four
  1509. QEdit commands which act on the Scrap Buffer.
  1510.  
  1511. The Scrap Buffer is a temporary holding area for marked Blocks of
  1512. text.  The commands Cut, Copy, Paste, and PasteOver are solely
  1513. responsible for placing text into the Scrap Buffer and copying text
  1514. from the Scrap Buffer.
  1515.  
  1516.  1-19
  1517.  
  1518. When you issue a Copy or Cut command (we will discuss how to use
  1519. these in the following section ), the marked Block is placed into
  1520. the Scrap Buffer.  The next time you Copy or Cut a Block into the
  1521. Scrap Buffer, the previous contents of the Scrap Buffer are deleted
  1522. and replaced with the new Block.
  1523.  
  1524. You can repeatedly use the Paste and PasteOver commands as many
  1525. times as needed to insert a copy of the Block held in the Scrap
  1526. Buffer at multiple positions in your file or files.  The Paste and
  1527. PasteOver commands do not purge the contents of the Scrap Buffer.
  1528.  
  1529. - Copy <grey +> and Paste <grey *> or PasteOver <Ctrl PrtSc>
  1530.   To copy a section of text from its present position and insert it
  1531.   somewhere else:
  1532.  
  1533.   1. Mark the text using the Block marking commands.
  1534.  
  1535.   2. Enter Copy <grey +>.  This places a copy of the marked text
  1536.      into the Scrap Buffer.
  1537.  
  1538.   3. If you want to insert the text somewhere else within the same
  1539.      file, use the cursor movement commands to place the cursor
  1540.      where you wish to insert the text.
  1541.  
  1542.   4. If you want to insert the text in another file, switch to that
  1543.      file using the NextFile, PrevFile, or EditFile command to
  1544.      access that file.  Then, likewise place the cursor at the
  1545.      desired position.
  1546.  
  1547.   5. Enter Paste <grey *> to insert the text.  If you have copied
  1548.      a column Block into the Scrap Buffer and wish to insert it
  1549.      by overlaying existing text then use PasteOver <Ctrl PrtSc>
  1550.      instead of Paste.
  1551.  
  1552.   Since Paste and PasteOver leave the contents of the Scrap Buffer
  1553.   intact, you can make multiple insertions in the same or different
  1554.   files. Simply move the cursor to the file and position where you
  1555.   wish to make additional insertions and enter Paste <grey *> or
  1556.   PasteOver <Ctrl PrtSc>.  Please note that the next time you issue
  1557.   a Cut or Copy command, the previous contents of the Scrap Buffer
  1558.   will be discarded.
  1559.  
  1560. - Cut <grey -> and Paste <grey *> or PasteOver <Ctrl PrtSc>
  1561.   Cut and Paste/PasteOver work exactly like Copy and Paste/PasteOver
  1562.   except that Cut will delete the marked Block from the file.  You
  1563.   can still make multiple insertions of the text using the Paste or
  1564.   PasteOver Commands.
  1565.  
  1566.  1-20
  1567.  
  1568. +----------------------------------------------------+
  1569.   QEdit Tip:                                         |
  1570.     QEdit can be configured to have the Cut and Copy |
  1571.     commands act on the current cursor line if no    |
  1572.     Block is marked. Refer to the "Advanced Options" |
  1573.     section of Chapter 2 for more information.       |
  1574. +----------------------------------------------------+
  1575.  
  1576.  
  1577. Manipulating Blocks Using Scratch Buffers
  1578.  
  1579. A Scratch Buffer is a special type of buffer to which you assign a 
  1580. name.  QEdit allows you to create and name up to 99 Scratch Buffers 
  1581. for each editing session.  These can be useful if you have several 
  1582. different Blocks of text that you want to insert in multiple 
  1583. locations.  The commands StoreScrbuff <Ctrl BS>, AppendScrbuff
  1584. <Ctrl BA>, and GetScrbuff <Ctrl BL> are used to place text in, and
  1585. retrieve text from, a Scratch Buffer.  Whenever you issue one of 
  1586. these commands, QEdit will ask you for the name of the Scratch 
  1587. Buffer.  The contents of all Scratch Buffers are discarded when the 
  1588. editor is terminated.
  1589.  
  1590. - StoreScrbuff <Ctrl BS> and AppendScrbuff <Ctrl BA>
  1591.  
  1592.   To place a Block of text into a named buffer:
  1593.  
  1594.   1. Mark the Block.
  1595.  
  1596.   2. If you want to create a new Scratch Buffer containing the 
  1597.      marked Block, enter StoreScrbuff <Ctrl BS>.  (This command is 
  1598.      also used if you wish to replace the current contents of a 
  1599.      Scratch Buffer with the marked Block.)  If you want to append 
  1600.      the marked Block to the current contents of the Scratch Buffer, 
  1601.      enter AppendScrbuff <Ctrl BA>.
  1602.  
  1603.   3. QEdit will prompt for the name of the Scratch Buffer.
  1604.        +----------------------------------------------------+
  1605.        |Store (Append) to buffer: <Esc = abort>             |
  1606.        |                                                    |
  1607.        +----------------------------------------------------+
  1608.  
  1609.   4. Enter a name.  It is best to use a name which reflects the
  1610.      contents of the buffer and is easily remembered.
  1611.  
  1612.   The Block is now stored in a Scratch Buffer under the assigned
  1613.   name.
  1614.  
  1615.   - GetScrbuff <Ctrl BL>
  1616.     To retrieve the contents of a named Scratch Buffer and insert it
  1617.     at the current cursor position:
  1618.  
  1619.     1. Position the cursor where you wish the contents of the named
  1620.        Scratch Buffer to be inserted.
  1621.  
  1622.  1-21
  1623.  
  1624.     2. Enter GetScrbuff <Ctrl BL>.  QEdit will prompt for the name
  1625.        of the Scratch Buffer to be retrieved.
  1626.  
  1627.        +---------------------------------------------+
  1628.        |Get from buffer: <Esc = abort>               |
  1629.        |                                             |
  1630.        +---------------------------------------------+
  1631.  
  1632.     3. Enter the name of the desired Scratch Buffer.
  1633.  
  1634.     4. Repeat the above steps whenever you want to insert the
  1635.        contents of a Scratch Buffer into your text.
  1636.  
  1637.  
  1638. Examples of Block Commands
  1639.  
  1640. This section contains examples of commonly used Block Commands.
  1641.  
  1642. - Copying or moving a Block within the same file.
  1643.  
  1644.   1. Position the cursor at the beginning of the Block to be copied
  1645.      or moved.
  1646.  
  1647.   2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1648.      MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1649.      mark a column of text.
  1650.  
  1651.   3. Position the cursor at the end of the Block to be copied or 
  1652.      moved.
  1653.  
  1654.   4. Enter DropAnchor, MarkLine, or MarkColumn again to mark the end
  1655.      of the Block.
  1656.  
  1657.   5. Move the cursor to the location in the file where you want to
  1658.      insert the marked Block.
  1659.  
  1660.   6. Enter CopyBlock <Alt C>, CopyOverBlock <Alt Z> (column Blocks
  1661.      only), or MoveBlock <Alt M>.
  1662.  
  1663.   7. Enter UnmarkBlock <Alt U> to unmark the Block.
  1664.  
  1665.   The Block has now been copied or moved.
  1666.  
  1667.  
  1668. - Copying or moving a Block to another file.
  1669.  
  1670.   1. Position the cursor at the beginning of the Block to be copied
  1671.      or moved.
  1672.  
  1673.   2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1674.      MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1675.      mark a column of text.
  1676.  
  1677.  1-22
  1678.  
  1679.   3. Position the cursor at the end of the Block to be copied or 
  1680.      moved.
  1681.  
  1682.   4. Switch to the "target" file using the file commands EditFile,
  1683.      NextFile, or PrevFile.
  1684.  
  1685.   5. Move the cursor to the location in the file where you want to
  1686.      insert the marked Block.
  1687.  
  1688.   6. Enter CopyBlock <Alt C>, CopyOverBlock <Alt Z> (column Blocks
  1689.      only), or MoveBlock <Alt M>.
  1690.  
  1691.   7. Enter UnmarkBlock <Alt U> to unmark the Block.
  1692.  
  1693.   The Block has now been copied or moved.
  1694.  
  1695.  
  1696. - Copying or moving a Block for multiple insertions in the same file.
  1697.  
  1698.   If you want to insert the same Block at several positions within a
  1699.   file, follow these steps:
  1700.  
  1701.   1. Position the cursor at the beginning of the Block to be copied
  1702.      or moved.
  1703.  
  1704.   2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1705.      MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1706.      mark a column of text.
  1707.  
  1708.   3. Position the cursor at the end of the Block to be copied or 
  1709.      moved.
  1710.  
  1711.   4. If you want to leave the Block in its original position and 
  1712.      insert copies of it at other locations, then enter Copy
  1713.      <grey +>.
  1714.  
  1715.      If you want to delete the Block from its original position and
  1716.      insert copies of it at other locations, then enter Cut <grey ->.
  1717.  
  1718.      The Block is now stored in the Scrap Buffer.
  1719.  
  1720.   5. Move the cursor to the location in the file where you want to
  1721.      insert the Block.
  1722.  
  1723.   6. Enter Paste <grey *> or PasteOver <Ctrl PrtSc> (column Blocks
  1724.      only).
  1725.  
  1726.   The Block is now inserted.  Repeat steps 5 and 6 for each 
  1727.   additional insertion.
  1728.  
  1729.  1-23
  1730.  
  1731. - Copying or moving a Block for multiple insertions in more than one
  1732.   file.
  1733.  
  1734.   If you want to insert the same Block at several positions in more
  1735.   than one file, follow these steps:
  1736.  
  1737.   1. Position the cursor at the beginning of the Block to be copied
  1738.      or moved.
  1739.  
  1740.   2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1741.      MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1742.      mark a column of text.
  1743.  
  1744.   3. Position the cursor at the end of the Block to be copied or 
  1745.      moved.
  1746.  
  1747.   4. If you want to leave the Block in its original position and
  1748.      insert copies of it at other locations, then enter Copy
  1749.      <grey +>.
  1750.  
  1751.      If you want to delete the Block from its original position and
  1752.      insert copies of it at other locations, then enter Cut <grey ->.
  1753.  
  1754.      The Block is now stored in the Scrap Buffer.
  1755.  
  1756.   5. Switch to the "target" file using the file commands EditFile,
  1757.      NextFile, or PrevFile.
  1758.  
  1759.   6. Move the cursor to the location in the file where you want to
  1760.      insert the Block.
  1761.  
  1762.   7. Enter Paste <grey *> or PasteOver <Ctrl PrtSc> (column Blocks
  1763.      only).
  1764.  
  1765.   The Block is now inserted.  Repeat steps 5-7 for each additional
  1766.   insertion.
  1767.  
  1768. - Copying multiple Blocks for insertion in one or more files.
  1769.  
  1770.   If you have several Blocks that you want to insert in several
  1771.   different files, follow these steps:
  1772.  
  1773.   1. Position the cursor at the beginning of the first Block.
  1774.  
  1775.   2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1776.      MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1777.      mark a column of text.
  1778.  
  1779.   3. Position the cursor at the end of the first Block.
  1780.  
  1781.   4. Enter AppendScrbuff <Ctrl BA> if you want to append to an
  1782.      existing Scratch Buffer.  Otherwise, enter StoreScrbuff
  1783.      <Ctrl BS> to create or overwrite an existing Scratch Buffer.
  1784.  
  1785.  1-24
  1786.  
  1787.   5.  QEdit will prompt for the name of the buffer.  Enter a name.
  1788.       (It is best to use a name which reflects the contents of the
  1789.       buffer and is easily remembered).
  1790.  
  1791.       The Block is now stored in a Scratch Buffer under the assigned
  1792.       name.  Repeat steps 1-5 for each additional Block you want to
  1793.       store.
  1794.  
  1795.   6. Switch to the "target" file using the file commands EditFile,
  1796.      NextFile, or PrevFile.
  1797.  
  1798.   7. Move the cursor to the location in the file where you want to
  1799.      insert a Block.
  1800.  
  1801.   8. Enter GetScrbuff <Ctrl BL>.  QEdit will prompt for the name of
  1802.      the Scratch Buffer.  Enter the name of the desired Scratch
  1803.      Buffer for insertion.
  1804.  
  1805.   Repeat steps 6 through 8 for each insertion of a stored Block.
  1806.  
  1807. Non-Block Commands
  1808. ------------------
  1809.  
  1810. In addition to QEdit's array of Block commands, there are also many
  1811. commands for manipulating your text which do not depend on marked
  1812. Blocks.  This section explains each of these non-Block commands in
  1813. detail.
  1814.  
  1815.  
  1816. Adding Text
  1817.  
  1818. - AddLine <F2>
  1819.   As its name implies, this command inserts a blank line in the 
  1820.   text. The line is added immediately below the current cursor line. 
  1821.   The cursor is moved to the new line.  The cursor column does not 
  1822.   change.
  1823.  
  1824. - InsertLine <Alt F2>
  1825.   This command inserts a blank line in the text above the cursor
  1826.   line.  The cursor remains on the new line and the cursor column
  1827.   does not change.
  1828.  
  1829. - Literal <Ctrl P>
  1830.   The Literal command is used to insert control characters into the
  1831.   text.  To use this command, enter <Ctrl P> followed by a control
  1832.   character.  The control character will be inserted into the text.
  1833.   For example, to insert a formfeed character (ASCII 12) in the
  1834.   text, enter <Ctrl P> <Ctrl L>.
  1835.  
  1836.  1-25
  1837.  
  1838.   This command is handy for entering the control characters 
  1839.   represented by ASCII decimal values 1 through 26.  Simply enter 
  1840.   <Ctrl P> followed by <Ctrl A> for ASCII character 1, or <Ctrl B> 
  1841.   for ASCII character 2 and so on, up to <Ctrl Z> for ASCII 
  1842.   character 26.
  1843. +-------------------------------------------------------+
  1844. | QEdit Tip:                                            |
  1845. |   An alternate and perhaps easier method of entering  |
  1846. |   control characters or any ASCII character into your |
  1847. |   text is to hold down the <Alt> key and enter the    |
  1848. |   decimal equivalent of the ASCII character using the |
  1849. |   numeric keypad. For example, to insert a formfeed   |
  1850. |   character (ASCII 12) in the text, just enter <Alt   |
  1851. |   12> using the numeric keypad.                       |
  1852. |                                                       |
  1853. |   If a linefeed character (ASCII 10) is entered,      |
  1854. |   QEdit will split the line at this position the next |
  1855. |   time the file is edited.                            |
  1856. +-------------------------------------------------------+
  1857.  
  1858. - ToggleBoxDraw <Shift F1>
  1859.   This is a specialized command which is really a mode of operation
  1860.   that can be switched ON or OFF.  If switched ON, the cursor
  1861.   movement keys (up, down, right, left) can be used to "draw" lines
  1862.   in the text.  This can be very useful for creating graphs and
  1863.   tables.  To switch Box Drawing mode ON, enter <Shift F1>.  To
  1864.   switch OFF, enter <Shift F1> again.
  1865.  
  1866. - ToggleEnterMatching <Esc><O><E>
  1867.   This is also a specialized command which is really a mode of
  1868.   operation that can be switched ON or OFF.  If switched ON, QEdit
  1869.   will automatically insert into the text a corresponding ), ], or "
  1870.   character each time a (, [, or " character, respectively, is
  1871.   entered.  To switch EnterMatching mode ON, enter <Esc><O><E>.  To
  1872.   switch OFF, enter <Esc><O><E> again.
  1873.  
  1874.  
  1875. Copying Text
  1876.  
  1877. - GetPrev <Ctrl - (dash)>
  1878.   This command copies the character directly above the cursor onto 
  1879.   the cursor line.  To get an idea of how this command works, place 
  1880.   the cursor at the beginning of any line which has text on the line 
  1881.   immediately above it.  Now press <Ctrl - (dash)> and hold it down. 
  1882.   The cursor will move to the right while copying the the characters 
  1883.   from the line above.
  1884.  
  1885. - DupLine <F4>
  1886.   This command simply makes a copy of the current cursor line and 
  1887.   inserts this copy on the line immediately below the cursor line. 
  1888.   The cursor is placed on the new line.
  1889.  
  1890.  1-26
  1891.  
  1892. - Copy <grey +> and Paste <grey *>
  1893.   Refer to the "Block Commands" section in this chapter for a 
  1894.   complete explanation of these commands.  The commands are included 
  1895.   here because, if desired, the User can configure QEdit so that 
  1896.   these commands act on the current cursor line in the same manner in 
  1897.   which they act on Blocks.  For more information on how to configure 
  1898.   this option, refer to the "Advanced Options" section of Chapter 2.
  1899.  
  1900.  
  1901. Moving Text
  1902.  
  1903. - Align
  1904.   This command lines up the left-most character of the cursor line 
  1905.   with the left-most character of the line above it.  This allows 
  1906.   you to align portions of text which require a common left margin. 
  1907.   This command also moves the cursor down one line; thus, large 
  1908.   portions of text can be aligned very quickly by entering this 
  1909.   command and holding the command key down.
  1910.  
  1911. - JoinLine  <Alt J>
  1912.   This command will delete the line below the current cursor line 
  1913.   and append it to the end of the cursor line.
  1914.  
  1915.   If the cursor is positioned on or before the last non-blank
  1916.   character of the line, the line below will be appended immediately
  1917.   following the last non-blank character.
  1918.  
  1919.   If the cursor is positioned beyond the last non-blank character of 
  1920.   the line, the line below will be appended beginning at the current 
  1921.   cursor position.
  1922.  
  1923.   If the line below the cursor line is blank, the blank line will be 
  1924.   deleted.
  1925.  
  1926. - SplitLine <Alt S>
  1927.   This command will delete all text on and to the right of the 
  1928.   cursor on the cursor line and will insert this text on a new line 
  1929.   immediately below the cursor line.  The cursor position will not 
  1930.   change.
  1931.  
  1932. - Return <Enter>
  1933.   Before reading the explanation of the Return command, it may be 
  1934.   helpful to review the discussion of Insert mode in the "Modes" 
  1935.   section in this chapter.
  1936.  
  1937.   If the editor is in Insert mode, this command performs like the 
  1938.   SplitLine command; that is, all text on and to the right of the 
  1939.   cursor on the cursor line will be deleted and inserted on a new 
  1940.   line immediately below the cursor line.  The cursor, however, will 
  1941.   be placed on the new line.
  1942.  
  1943.   If the editor is not in Insert mode, this command will simply 
  1944.   place the cursor at the beginning of the line below the cursor 
  1945.   line.  No text will be affected.
  1946.  
  1947.  1-27
  1948.  
  1949.   If the editor is in AutoIndent mode, the cursor will be placed at
  1950.   the left margin instead of at the beginning of the line.
  1951.  
  1952. +---------------------------------+
  1953. | QEdit Tip:                      |
  1954. |   QEdit can be configured so    |
  1955. |   that the Return command does  |
  1956. |   not split lines in Insert     |
  1957. |   mode.                         |
  1958. |   Refer to the "Advanced        |
  1959. |   Options" section of Chapter 2 |
  1960. |   for more information.         |
  1961. +---------------------------------+
  1962.  
  1963. - Cut <grey -> and Paste <grey *>
  1964.   Refer to the "Block Commands" section in this chapter for a
  1965.   complete explanation of these commands.  The commands are included
  1966.   here because, if desired, the User can configure QEdit so that
  1967.   these commands act on the current cursor line in the same manner
  1968.   in which they act on Blocks.  For more information on how to
  1969.   configure this option, refer to the "Advanced Options" section of
  1970.   Chapter 2.
  1971.  
  1972. - ShiftLeft <Shift F7> and ShiftRight <Shift F8>
  1973.   Refer to the "Block Commands" section in this chapter for a
  1974.   complete explanation of these commands.  The commands are included
  1975.   here because, if there is no marked Block in the text, these
  1976.   commands will act on the current cursor line.
  1977.  
  1978.  
  1979. Deleting And Undeleting Text
  1980.  
  1981. - Backspace <Backspace> and DelLtWord <Ctrl Backspace>
  1982.   If Insert mode is ON, the Backspace command deletes the character
  1983.   to the left of the cursor.  The text to the right of the cursor is
  1984.   pulled behind the cursor as it moves to the left.  If the cursor
  1985.   is in column one and you enter Backspace, the cursor line is
  1986.   appended to the line immediately above.
  1987.  
  1988.   If Insert mode is OFF, the Backspace command works the same as
  1989.   above except the text to the right of the cursor is not pulled
  1990.   behind the cursor as it moves left.
  1991.  
  1992.   The DelLtWord command is a backspace for "words".  It works just
  1993.   like the Backspace command, except that it deletes all characters
  1994.   from the cursor to the beginning of the previous word.
  1995.  
  1996. - DelCh <Del> and DelRtWord <Ctrl T>
  1997.   DelCh will delete the character at the cursor position and pull
  1998.   the text to the right of the cursor, one column to the left.
  1999.  
  2000.   If the cursor position is to the right of the last non-blank
  2001.   character on the cursor line, the line immediately below will be
  2002.   appended to the cursor line.
  2003.  
  2004.  1-28
  2005.  
  2006.   The DelRtWord command is a character delete for "words".  It
  2007.   works just like the DelCh command, except that it deletes
  2008.   all characters from the cursor to the beginning of the following
  2009.   word.
  2010.  
  2011. - DelToEol <F6>
  2012.   This command deletes the character at the cursor position and all
  2013.   text to the right of the cursor on the current cursor line.  The
  2014.   cursor position does not change.
  2015.  
  2016. - DelLine <Alt D>
  2017.   This command deletes the current cursor line from the text. All
  2018.   text below the deleted line is shifted up one line.
  2019.  
  2020. - UndoCursorline  <Ctrl QL>
  2021.   This command allows you to reverse any changes you have made to
  2022.   the cursor line.  This can be helpful if you accidentally delete
  2023.   or change part of a line, or you just change your mind and want
  2024.   the cursor line back the way it was.  This command must be issued
  2025.   before the cursor is moved from the current cursor line and before
  2026.   any file or window commands are entered.  Changes made using the
  2027.   FindReplace command cannot be reversed with this command.
  2028.  
  2029. - UnKill <Ctrl U>
  2030.   This command allows you to retrieve text that has been deleted by
  2031.   the DeleteBlock, DelLine, DelRtWord, or DelToEol commands.  Refer
  2032.   to "The Kill Buffer" section in this chapter for a complete
  2033.   explanation on the use of this command.
  2034.  
  2035.  
  2036. Replacing Text
  2037.  
  2038. QEdit provides the ability to search for specific strings of
  2039. characters throughout your text and then replace all, some, or none
  2040. of them with another string of characters.  (If you want to search
  2041. for strings of characters without replacing them, use the Find
  2042. command which is described in the "Moving Through a File" section in
  2043. this chapter.)
  2044.  
  2045. - FindReplace <Ctrl QA>
  2046.   This command will search for a specific string of characters in
  2047.   the current file, and optionally, replace it with another string
  2048.   of characters.
  2049.  
  2050.   Upon entering the FindReplace command, QEdit will prompt for the
  2051.   string of characters for which to search.
  2052.     +-------------------------------------------------+
  2053.     |Search For: <Esc = Abort>                        |
  2054.     |                                                 |
  2055.     +-------------------------------------------------+
  2056.  
  2057.   Enter the desired string of characters and press <Enter>.
  2058.  
  2059.  1-29
  2060.  
  2061.   QEdit will then prompt for a new string of characters (to replace
  2062.   the old string).
  2063.     +-------------------------------------------------+
  2064.     |Replace with: <Esc = Abort>                      |
  2065.     |                                                 |
  2066.     +-------------------------------------------------+
  2067.  
  2068.   Enter the new string of characters and press <Enter>.
  2069.  
  2070.   QEdit will then prompt for the search options you wish to use.
  2071.     +------------------------------------------------------------+
  2072.     |Options [BGLIWN] (Back Global Local Ignore-case Whole-words |
  2073.     |No-prompting):                                              |
  2074.     |I                                                           |
  2075.     +------------------------------------------------------------+
  2076.  
  2077.   Enter the letter(s) corresponding to the option(s) you want and
  2078.   press <Enter>.  The available options are (see Appendix E for
  2079.   additional options):
  2080.  
  2081.    [B] = Search backward from the current cursor position.  If you
  2082.          choose "B", QEdit will search backward from the cursor
  2083.          position toward the beginning of the file.  Otherwise, it
  2084.          will search from the cursor position toward the end of the
  2085.          file.
  2086.  
  2087.    [I] = Ignore the case (capital or lowercase) of the search 
  2088.          string.  For example, "Hello" would match "hello" when this 
  2089.          option is chosen.  This option is set ON by default.
  2090.  
  2091.    [W] = Search for whole words only.  For example, when this option
  2092.          is chosen, the word "sent" will match only the actual word
  2093.          "sent".  Otherwise, any other words that contain the
  2094.          string (such as "sentence" or "absent") would also match.
  2095.  
  2096.    [N] = Find and replace without prompting.  If you choose "N",
  2097.          QEdit will find and replace every occurrence of the search
  2098.          string, without asking you if you want to replace each
  2099.          individual occurrence.
  2100.  
  2101.   If you select the "No-prompting" option, QEdit will find and 
  2102.   replace every occurrence of the search string with no further User 
  2103.   intervention.  If you do not select the "No-prompting" option, 
  2104.   QEdit will prompt at every occurrence of the search string with:
  2105.     +-------------------------------------+
  2106.     |  Replace (Yes/No/Only/Rest/Quit):   |
  2107.     +-------------------------------------+
  2108.  
  2109.   Valid responses are:
  2110.     <Y>es  - Replace the search string with the new string
  2111.              and continue to the next occurrence.
  2112.     <N>o   - Do not replace the search string, but continue
  2113.              to the next occurrence.
  2114.  
  2115.  1-30
  2116.  
  2117.     <O>nly - Replace the search string with the new string
  2118.              and quit.
  2119.     <R>est - Replace the search string with the new string
  2120.              and replace the rest of the occurrences with no
  2121.              further prompts.
  2122.     <Q>uit - Abort the FindReplace process.
  2123.  
  2124.  
  2125. - RepeatFind <Ctrl L>
  2126.   This command will reissue the previous Find or FindReplace command
  2127.   using the same character strings and options.
  2128.  
  2129.  
  2130. The Kill Buffer - A Safety Net
  2131. ------------------------------
  2132.  
  2133. QEdit maintains a temporary storage area for deleted text.  This
  2134. provides the User a safeguard against incorrectly or inadvertently
  2135. deleting text.  This recovery mechanism is automatically in effect
  2136. when QEdit is running.  No action is required from the User until
  2137. there is a need to recover deleted text.
  2138.  
  2139. The temporary storage area is called the Kill Buffer.  QEdit will
  2140. place into the Kill Buffer text which has been deleted by these
  2141. commands:
  2142.  
  2143.              DeleteBlock  <Alt G>
  2144.              DelLine      <Alt D>
  2145.              DelRtWord    <Ctrl T>
  2146.              DelToEol     <F6>
  2147.  
  2148. To understand how the Kill Buffer works and how text is recovered
  2149. from the Kill Buffer, refer to the illustration below.
  2150.  
  2151.  
  2152.                        The Kill Buffer
  2153.  
  2154.      Entry    Command
  2155.      Number   Entered      Buffer Contents             top
  2156.     +-----------------------------------------------------+
  2157.     |  4    | DelToEol   | part of this line was deleted. |
  2158.     |-------+------------+--------------------------------|
  2159.     |  3    | DelRtWord  | (1 word deleted)               |
  2160.     |-------+------------+--------------------------------|
  2161.     |  2    | DelLine    | This entire line was deleted.  |
  2162.     |-------+------------+--------------------------------|
  2163.     |  1    | DelLine    | This entire line was deleted.  |
  2164.     |-------+------------+--------------------------------|
  2165.     | empty |            |                                |
  2166.     |-------+------------+--------------------------------|
  2167.     | empty |            |                                |
  2168.     +-----------------------------------------------------+
  2169.                                                      bottom
  2170.  
  2171.  1-31
  2172.  
  2173. Each time one of the text deletion commands is used, a new entry is 
  2174. made in the Kill Buffer.  In the above example, four deletion
  2175. commands have been issued.  The text from these four commands has
  2176. been stored in the Kill Buffer from top to bottom. In other words, 
  2177. when the DelToEol command was issued (entry #4), the first three 
  2178. entries were pushed toward the bottom of the Kill Buffer and the 
  2179. newly deleted text was entered at the top.
  2180.  
  2181. In the example, the Kill Buffer has enough room for six entries. 
  2182. When a seventh entry is made, the oldest entry, or entry number one, 
  2183. will be discarded from the Kill Buffer.  Once discarded from the 
  2184. Kill Buffer, that text can no longer be recovered.
  2185.  
  2186. To recover deleted text, the UnKill <Ctrl U> command is used. Each 
  2187. time the UnKill command is issued the most recent entry (the "top" 
  2188. entry of the Kill Buffer) is retrieved and restored to the file. 
  2189. This entry is then deleted from the Kill Buffer, and all remaining 
  2190. entries move toward the top of the buffer by one position. In the 
  2191. example, the first time the UnKill command is issued, entry #4 will 
  2192. be recovered. Next, entry #3 will be recovered, and so on. Thus, 
  2193. recovering deleted text follows the rule of LIFO (last in - first 
  2194. out). The last entry of deleted text will be the first one recovered 
  2195. and the first entry of deleted text will be the last one recovered.
  2196.  
  2197. Here are some additional items of which to be aware regarding the
  2198. Kill Buffer and its uses.
  2199.  
  2200. - A separate Kill Buffer is maintained for each file loaded into
  2201.   QEdit.  The Kill Buffer for each file exists only as long as the
  2202.   file is loaded.
  2203.  
  2204. - The default size of the Kill Buffer is 30 entries.  This may be
  2205.   changed using the QEdit configuration program. Refer to the
  2206.   "General Options" section of Chapter 2 for more information.
  2207.  
  2208. - The text deleted using the DelLine, DelRtWord, and DelToEol 
  2209.   commands will take up one entry in the Kill Buffer each time the 
  2210.   commands are executed.  The text deleted using the DeleteBlock 
  2211.   command will take up as many entries as there are lines in the 
  2212.   Block.
  2213.  
  2214.   It is important to note that regardless of how large the Kill 
  2215.   Buffer is configured to be, it may be possible to mark and delete 
  2216.   a Block in the file which is larger than the buffer.  If this 
  2217.   situation arises, QEdit will save the deleted text in the Kill 
  2218.   Buffer from the bottom up.  For example, if a marked Block is 200 
  2219.   lines long and five lines too large for the Kill Buffer, then the 
  2220.   top five lines of the Block will not be loaded into the Kill Buffer.
  2221.  
  2222. - When issuing the UnKill command to recover deleted text, deleted
  2223.   lines will be inserted immediately before the current cursor line,
  2224.   and deleted words will be inserted immediately before the current
  2225.   cursor position.
  2226.  
  2227.  1-32
  2228.  
  2229. Macros
  2230. ======
  2231.  
  2232. A macro is a series of commands and/or keystrokes which are assigned
  2233. to a single key.  If you find that you are repeatedly entering the
  2234. same series of commands and keystrokes (for example, a row of
  2235. asterisks, three Returns, and then a Tab), using macros will allow
  2236. you to easily assign these to a single key, such as <Shift F6>.
  2237. Then, the next time you wish to enter a row of asterisks, three
  2238. Returns, and a Tab, you will only have to press <Shift F6>.
  2239.  
  2240. Creating, using, and saving macros for later use is both quick and
  2241. simple.  By taking a few minutes to review the following sections,
  2242. you should be able to save plenty of time and keystrokes in your
  2243. future editing with the help of macros.  (For advanced macro usage,
  2244. see QMAC.DOC on the QEdit software diskette.)
  2245.  
  2246.  
  2247. Creating Macros
  2248.  
  2249. Once you have decided to assign a series of commands and keystrokes
  2250. to a single key, creating the macro is simply a matter of entering
  2251. this series while QEdit "records" the macro.
  2252.  
  2253. To create a macro follow these steps:
  2254.  
  2255. 1. Position the text and cursor to where you will begin entering the
  2256.    series of commands and keys.  (You may want to practice your
  2257.    series once or twice before actually recording the macro.)
  2258.  
  2259. 2. Enter the MacroRecord <Ctrl M> command.  An "R" will appear on
  2260.    the Status Line to indicate macro recording is ON.  The following
  2261.    message will appear:
  2262.      +--------------------------------------------------------+
  2263.      |Assign to what key: (Enter for "scrap", Escape to Abort)|
  2264.      +--------------------------------------------------------+
  2265.  
  2266. 3. Enter the key to which you want to assign the series of commands 
  2267.    and keystrokes.  There are two requirements here.  The key must 
  2268.    be a "configurable" key.  A list of all configurable keys is 
  2269.    contained in Appendix B.  Also, the key cannot have a command 
  2270.    already assigned to it.
  2271.  
  2272.    You may assign the macro to a "scrap" or temporary area by simply
  2273.    pressing <Enter>.  The scrap area will hold your macro until
  2274.    another macro is recorded.
  2275.  
  2276. 4. Enter the series of commands and keystrokes to be assigned. Note
  2277.    that the "R" still appears on the Status Line.
  2278.  
  2279. 5. Enter the MacroRecord <Ctrl M> command again.  Macro recording is
  2280.    now OFF.  The "R" no longer appears on the the Status Line.  The
  2281.    macro is now created and assigned to the key specified in step 3.
  2282.  
  2283.  1-33
  2284.  
  2285. Using Macros
  2286.  
  2287. To use your macro, simply position the text and cursor properly and
  2288. press the key to which you assigned the macro, or use the
  2289. ExecuteScrap <Ctrl Enter> command to retrieve the latest macro from
  2290. the scrap area. If the macro does not behave as you expected
  2291. (perhaps you inadvertently hit an extraneous key while recording),
  2292. simply repeat the above steps.  Your old macro assignment will be
  2293. replaced with the new one.
  2294.  
  2295. +-----------------------------------------------------+
  2296. | QEdit Tip:                                          |
  2297. |   Be aware of modes, especially Insert mode, when   |
  2298. |   recording and using macros.  Macros recorded with |
  2299. |   Insert mode ON and then used with Insert mode OFF |
  2300. |   (and vice-versa) may behave very strangely.       |
  2301. +-----------------------------------------------------+
  2302.  
  2303.  
  2304. Saving and Reloading Macros
  2305.  
  2306. Normally, macros created using this process are lost once the editor
  2307. is terminated.  QEdit, however, provides an easy method of saving
  2308. your macros so that they may be reloaded for use in any future
  2309. editing session.
  2310.  
  2311. Macros can be saved in a binary disk file.  You specify the name of
  2312. this file.  Once macros have been created, enter the MacroWrite
  2313. <Esc><M><W> command.  QEdit will prompt with:
  2314.   +------------------------------------------------+
  2315.   |Macro file to write: <Esc = abort>              |
  2316.   |                                                |
  2317.   +------------------------------------------------+
  2318.  
  2319. Enter the name of the file to contain your macros.  The macros will
  2320. be saved under the given filename.  You may notice that this file
  2321. now appears in the current DOS directory.  Macros assigned to the
  2322. scrap area cannot be saved.
  2323.  
  2324. In a future editing session, if you wish to reuse your previously
  2325. defined macros, you need only reload the macro file.  To do this
  2326. enter the MacroRead <Esc><M><R> command.  QEdit will prompt with:
  2327.   +------------------------------------------------+
  2328.   |Macro file to read: <Esc = abort>               |
  2329.   |                                                |
  2330.   +------------------------------------------------+
  2331.  
  2332. Enter the name of the previously saved macro file.  Your macros will
  2333. be reloaded.  You may then use them in the same manner as before.
  2334.  
  2335. The QEdit configuration program provides an alternate method of
  2336. creating macros.  Refer to the "Keyboard Configuration" section of
  2337. Chapter 2 for more information.
  2338.  
  2339.  1-34
  2340.  
  2341. Example of a Macro
  2342.  
  2343. To create a macro which will insert a formfeed character (ASCII
  2344. 12) at column one of the current cursor line, do the following:
  2345.  
  2346. 1. Position the cursor in the text where you would like to insert
  2347.    the formfeed character.
  2348.  
  2349. 2. Enter MacroRecord <Ctrl M>.
  2350.  
  2351. 3. Press <Alt F1> to assign the macro to this key.
  2352.  
  2353. 4. Press the following series of keys:
  2354.      <Home>     (for the BegLine command)
  2355.      <Ctrl P>   (for the Literal command)
  2356.      <Ctrl L>   (a formfeed character)
  2357.  
  2358. 5. Enter MacroRecord <Ctrl M>.  The macro is now created and
  2359.    assigned to the <Alt F1> key.
  2360.  
  2361. Now, whenever you enter <Alt F1>, the cursor will be moved to column
  2362. one and a formfeed character will be inserted, just as if you had
  2363. typed it in from the keyboard.
  2364.  
  2365.  
  2366. Printing
  2367. ========
  2368.  
  2369. QEdit allows you to print either your entire current file or a
  2370. portion of the current file.
  2371.  
  2372. To print the entire current file, simply enter the PrintAll
  2373. <Alt P><A> command.  The entire current file will be printed.
  2374.  
  2375. To print a portion of the current file, first mark the portion of
  2376. the file to be printed using the Block marking commands.  (Refer to
  2377. the "Block Commands" section in this chapter.)  Next, enter the
  2378. PrintBlock <Alt P><B> command.  Only the marked Block portion of the
  2379. file will be printed.
  2380.  
  2381.  1-35
  2382.  
  2383. Print Formatting
  2384.  
  2385. Two commands are provided for setting the left margin and the page 
  2386. size.  Appendix E contains information on commands for setting the 
  2387. top and bottom print margins. (The left margin and page size may 
  2388. also be specified using the configuration program.  Refer to the 
  2389. "Printer Options" section of Chapter 2 and to Appendix E for more 
  2390. information.)
  2391.  
  2392. - SetPrintLeftMargin <Alt P><L>
  2393.   This command specifies the number of blank spaces to be used as a
  2394.   left margin. QEdit will prompt with:
  2395.     +------------------------------------------+
  2396.     |Printer left margin [0..80]: <Esc = Abort>|
  2397.     |0                                         |
  2398.     +------------------------------------------+
  2399.  
  2400.   Enter the left margin length from zero to 80.
  2401.  
  2402. - SetPrintPageSize <Alt P><P>
  2403.   This command specifies the the number of lines to be printed on
  2404.   each page. QEdit will prompt with:
  2405.     +-----------------------------------------+
  2406.     |Printer page size [0..400]: <Esc = Abort>|
  2407.     |0                                        |
  2408.     +-----------------------------------------+
  2409.  
  2410.   Enter a page size from zero to 400.  A zero will instruct QEdit
  2411.   to print continuously without page breaks.
  2412.  
  2413.  
  2414. Formfeeds
  2415.  
  2416. QEdit will automatically send a formfeed character (ASCII 12) to the
  2417. printer at the end of each page.  A page is determined by the page
  2418. size as explained in the section above.
  2419.  
  2420. At times you may find it desirable to insert formfeed characters
  2421. directly into your text.  For example, you want the page size for
  2422. your text to be 55 lines, which you have set using the
  2423. SetPrintPageSize command, but there is a 15-line table in the text
  2424. that should appear on a page by itself.  To accomplish this, simply
  2425. insert formfeed characters immediately before and after the table.
  2426.  
  2427. To insert a formfeed character in the text, enter the Literal
  2428. <Ctrl P> command followed by a formfeed <Ctrl L> character. If you
  2429. need to insert formfeed characters into your text repeatedly, you
  2430. may want to use a macro.  An example of a macro to insert formfeed
  2431. characters can be found in the "Macros" section in this chapter.
  2432.  
  2433. It is also possible, from within QEdit, to send a formfeed character
  2434. to the printer, causing the printer to eject a page.  To do this,
  2435. simply enter the PrintEject <Alt P><F> command.
  2436.  
  2437.  1-36
  2438.  
  2439. The Shell and Dos commands
  2440. ==========================
  2441.  
  2442. (For the following discussion, "Dos" is a QEdit command, while "DOS"
  2443. refers to the computer's operating system.)
  2444.  
  2445. QEdit provides two very helpful commands that allow you to interact
  2446. with DOS from within the editor.  The commands, Shell and Dos, allow
  2447. you to perform most functions that you would normally execute from
  2448. the DOS command line, then return you to your original position in
  2449. the editor.
  2450.  
  2451. QEdit also has an option which frees up memory when executing the
  2452. Shell and Dos commands.  For details, see "Swapping" in Appendix E.
  2453.  
  2454. - Shell <F9>
  2455.   This command should be used when executing multiple DOS commands.
  2456.   Upon entering the Shell command, control will be passed to DOS.
  2457.   The DOS prompt will appear on the screen, just as if no other
  2458.   programs were running.  You may now enter most DOS commands.
  2459.   (Some exceptions are noted below.)  Once you have entered all the
  2460.   desired DOS commands, simply type "exit <Enter>" and control
  2461.   will be passed back to QEdit.  You will be positioned in the file
  2462.   exactly where you were when the Shell command was entered.
  2463.  
  2464. - Dos <Alt F9>
  2465.   This command should be used when executing a single DOS command.
  2466.   Upon entering this command, QEdit will prompt with:
  2467.  
  2468.   +-------------------------------------------------+
  2469.   |Execute what: <Esc = Abort>                      |
  2470.   |                                                 |
  2471.   +-------------------------------------------------+
  2472.  
  2473.   You may now enter almost any DOS command.  (Some exceptions are
  2474.   noted below.)  Once the DOS command has completed, pressing any
  2475.   key will pass control back to QEdit.
  2476.  
  2477. You should not execute any TSR programs (programs that terminate but
  2478. remain resident in your computer) from the Shell or Dos commands.
  2479. For example, the DOS PRINT and GRAPHICS commands are TSR programs.
  2480.  
  2481. If you mistakenly execute a TSR program from QEdit's Shell or Dos
  2482. command, the computer's memory allocation scheme will probably
  2483. become fragmented, and as a result, QEdit's available memory may
  2484. become severely limited.  You should save your files, terminate
  2485. QEdit, and then reboot the computer.
  2486.  
  2487.  1-37
  2488.  
  2489. Word Processing Commands
  2490. ========================
  2491.  
  2492. QEdit has all the features you need to do basic word processing.  In
  2493. addition to the commands which enable you to view and edit your text
  2494. (discussed in previous sections), QEdit provides word-wrapping and
  2495. paragraph reformatting capabilities.  Also, Appendix E contains
  2496. information on QEdit commands for changing case, centering a line
  2497. (or block of lines), and filling a block.
  2498.  
  2499. - The right margin
  2500.   To benefit from the word-wrap and paragraph reformatting features
  2501.   of QEdit, an appropriate right margin must first be set.  The
  2502.   default setting is column 60.  This may be changed using the
  2503.   configuration program.  (Refer to the "General Options" section of
  2504.   Chapter 2 for instructions on how to change the right margin
  2505.   setting.)  This value of the right margin will be used each time
  2506.   the editor is initiated.
  2507.  
  2508.   QEdit provides the ability to change the right margin setting
  2509.   temporarily while the editor is running without affecting the
  2510.   permanent setting. To change the right margin setting temporarily,
  2511.   enter the SetRmargin <Ctrl OR> command.  QEdit will prompt with:
  2512.  
  2513.   +------------------------------------+
  2514.   |right margin [1..300]: <Esc = abort>|
  2515.   |60                                  |
  2516.   +------------------------------------+
  2517.  
  2518.   Enter the desired column number for the right margin.  The new
  2519.   setting will be in effect until the SetRmargin command is entered
  2520.   again or the next time the editor is initiated.  WordWrap mode is
  2521.   automatically switched ON whenever the right margin is set using
  2522.   this command.
  2523.  
  2524. - WordWrap
  2525.   WordWrap is a QEdit mode which can be switched ON and OFF
  2526.   using the ToggleWordwrap <Ctrl OW> command.  When switched ON,
  2527.   this mode will cause the cursor to advance automatically to the
  2528.   next line when text is being entered.
  2529.  
  2530.   The cursor will advance to the next line based on the right
  2531.   margin, which is set using the SetRmargin <Ctrl OR> command.  Once
  2532.   the cursor reaches the right margin and a non-blank character is
  2533.   typed, the cursor, along with the word (i.e., any continuous
  2534.   string of non-blank characters) currently being typed, will be
  2535.   advanced to the next line.
  2536.  
  2537.   The cursor will not advance to the next line if the current line
  2538.   does not contain at least one space.
  2539.  
  2540.  1-38
  2541.  
  2542. - Paragraph Reformatting
  2543.   The WrapPara <Alt B> command will reformat text from the current
  2544.   cursor position to the next blank line or the end of the file.
  2545.  
  2546.   The right-hand side of the text will be reformatted based on the
  2547.   right margin.  The right margin is set using the SetRmargin
  2548.   <Ctrl OR> command.
  2549.  
  2550.   The left-hand side of the text will be reformatted based on
  2551.   AutoIndent mode.  If AutoIndent mode is switched OFF, the left
  2552.   margin will be column one.  If AutoIndent mode is switched ON, the
  2553.   first non-blank character on the line immediately AFTER the cursor
  2554.   line will be used for the left margin.  Using the line AFTER the
  2555.   cursor line allows for special indentation for the first line of a
  2556.   paragraph.
  2557.  
  2558.  
  2559. Modes
  2560. =====
  2561.  
  2562. QEdit uses modes to affect the operation of the editor.  In general,
  2563. a QEdit mode is a state during which certain commands or keystrokes
  2564. behave differently.  Following is an explanation of all the QEdit
  2565. modes.
  2566.  
  2567. - Insert mode
  2568.   Insert mode can be switched ON and OFF by pressing the <Ins> key.
  2569.   When Insert mode is ON, an "I" will appear on the Status Line.
  2570.   The following table describes the commands and keystrokes which
  2571.   are affected by Insert mode.
  2572.  
  2573.  
  2574.   Command/
  2575.   Keystroke     Insert ON                 Insert OFF
  2576.   -----------   ----------------------    ---------------------
  2577.   Characters,   Shift text to right       Overwrite existing
  2578.   Space         of cursor, one column     text.
  2579.                 to the right.
  2580.  
  2581.   Backspace     Deletes character/word    Deletes character/word
  2582.                 to left of cursor.        to left of cursor.
  2583.                 Text to right of cursor   Text to right of cursor
  2584.                 shifts left one column.   does not shift.
  2585.  
  2586.   Return        Splits line at cursor     Does not split line.
  2587.                 position.  Cursor moves   Cursor moves to next
  2588.                 to next line.             line.
  2589.  
  2590.   TabLt,        Tabs cursor and shifts    Tabs cursor only.
  2591.   TabRt         text same number of
  2592.                 positions.
  2593.  
  2594.  1-39
  2595.  
  2596. - AutoIndent mode
  2597.   AutoIndent mode is switched ON and OFF using the ToggleIndent
  2598.   <Ctrl QI> command.  This mode, when ON, positions the cursor at
  2599.   the current left margin (This is not the same as the print left
  2600.   margin.) whenever the <Enter> key is pressed.  The current left
  2601.   margin is determined by the first non-blank character on the
  2602.   immediately preceding line.  The following table describes the
  2603.   commands and keystrokes which are affected by AutoIndent mode.
  2604.  
  2605.   Command/
  2606.   Keystroke   AutoIndent ON                 AutoIndent OFF
  2607.   ---------   --------------------------    ------------------------
  2608.  
  2609.   Return      Cursor positioned below       Cursor positioned at
  2610.               first non-blank character     column one.
  2611.               of previous line.
  2612.  
  2613.   WrapPara    When reformatting, the left   A left margin of zero is
  2614.               margin is determined from     used when reformatting.
  2615.               the first non-blank
  2616.               character on the line
  2617.               immediately following the
  2618.               cursor line.
  2619.  
  2620. - C mode
  2621.   This mode is specifically for "C" language programming.  It is
  2622.   switched ON and OFF using the configuration program.  (Refer to
  2623.   the "General Options" section of Chapter 2 for information on
  2624.   switching C mode ON and OFF.)  C mode is only in effect when
  2625.   AutoIndent mode is also ON.
  2626.  
  2627.   C Mode, when switched ON, affects files with a ".c", ".cpp",
  2628.   ".cxx", ".h", ".hpp", or ".hxx", file extension.  When the current
  2629.   cursor line contains a "{" and the <Enter> key is pressed, QEdit
  2630.   issues a normal Return followed by a TabRt command.  Additionally,
  2631.   when a "}" character is entered, QEdit first issues a TabLt
  2632.   command and then enters the "}" character.
  2633.  
  2634. - WordWrap mode
  2635.   WordWrap mode is switched ON and OFF using the ToggleWordwrap
  2636.   <Ctrl OW> command.  When switched ON, this mode will cause the
  2637.   cursor to advance to the next line automatically when text is
  2638.   being entered.
  2639.  
  2640.   The cursor will advance to the next line based on the right
  2641.   margin, which is set using the SetRmargin <Ctrl OR> command. Once
  2642.   the cursor reaches the right margin and a non-blank character is
  2643.   typed, the cursor, along with the word (i.e., any continuous
  2644.   string of non-blank characters) currently being typed, will be
  2645.   advanced to the next line.
  2646.  
  2647.   The cursor will not advance to the next line if the current line
  2648.   does not contain at least one space.
  2649.  
  2650.  1-40
  2651.  
  2652. - BackUp mode
  2653.   BackUp mode is switched ON and OFF using the ToggleBakups
  2654.   <Esc><O><B> command.  When BackUp Mode is switched ON, QEdit will
  2655.   create a backup copy (using the .bak file extension) for any file
  2656.   that is edited and saved.  The backup copy of the file is an image
  2657.   of the file before it was last edited and saved.  When BackUp mode
  2658.   is OFF, no backup files will be created.
  2659.  
  2660. - MacroRecord mode
  2661.   MacroRecord mode is switched ON and OFF using the MacroRecord
  2662.   <Ctrl M> command.  This mode, when ON, records and assigns a
  2663.   series of commands and keystrokes to a designated key (or scrap
  2664.   area).  This creates a macro.  For a complete explanation of
  2665.   macros and their use, refer to the "Macros" section in this
  2666.   chapter.
  2667.  
  2668. - EnterMatching mode
  2669.   EnterMatching mode is switched ON and OFF using the
  2670.   ToggleEnterMatching <Esc><O><E> command.  If switched ON, QEdit
  2671.   will automatically insert into the text a corresponding ), ], or "
  2672.   character each time a (, [, or " character, respectively, is
  2673.   entered.
  2674.  
  2675. - Box Drawing mode
  2676.   Box Drawing mode is switched ON and OFF using the ToggleBoxDraw
  2677.   <Shift F1> command.  If switched ON, the cursor movement keys (up,
  2678.   down, right, left) can be used to "draw" lines in the text.  This
  2679.   can be very useful for creating charts and tables.  All of the
  2680.   diagrams found in this manual were created using Box Drawing.  The
  2681.   ToggleBoxType command allows you to select different line drawing
  2682.   styles.
  2683.  
  2684. - Smart Tabs mode
  2685.   Smart Tabs mode is switched ON and OFF using the ToggleSmartTabs
  2686.   <Ctrl QT> command.  If switched ON, the TabRt and TabLt commands
  2687.   will place the cursor beneath the first character of the next (or
  2688.   previous) word on the first nonblank line preceding the current
  2689.   cursor line.
  2690.  
  2691.   Smart Tabs mode should NOT be used in conjunction with C mode.
  2692.  
  2693. - Physical Tab Expansion mode
  2694.   Physical Tab Expansion mode is switched ON and OFF using the
  2695.   ToggleTabsExpand <Alt V> command.  If switched ON, physical tab
  2696.   characters (ASCII 9's) found in a file will be expanded into
  2697.   spaces according to the Physical Tab Width set in the
  2698.   configuration program.  If switched OFF, physical tabs will be
  2699.   displayed on the screen and a physical tab character will be
  2700.   placed in the text each time the TabRt command is entered.
  2701.  
  2702.  1-41
  2703.  
  2704. +--------------------------------------------------+
  2705. | QEdit Tip:                                       |
  2706. |   In general, Physical Tab Expansion mode should |
  2707. |   always be set ON.  You would only want to set  |
  2708. |   it OFF if you were editing binary or data      |
  2709. |   files that contain or require physical tabs.   |
  2710. +--------------------------------------------------+
  2711.  
  2712. - Tabs Out mode
  2713.   Tabs Out mode is switched ON and OFF using the ToggleTabsOut
  2714.   <Alt I> command.  If switched ON, continuous spaces in a line of
  2715.   text will be replaced with physical tabs (ASCII 9's) according to
  2716.   the Physical Tab Width set in the configuration program.  Only
  2717.   spaces in edited lines are replaced with physical tabs. Spaces
  2718.   falling between single or double quotes will not be replaced.
  2719.  
  2720.  1-42
  2721.  
  2722. CHAPTER 2.  CUSTOMIZING QEDIT_______________________________________
  2723.  
  2724. QEdit provides a configuration capability which allows the User to
  2725. customize the editor to suit individual preferences.  There are a
  2726. wide range of options which may be customized including key
  2727. assignments, color, tab settings, and printer options.
  2728.  
  2729. Of course, customizing QEdit is not a requirement.  If you like the
  2730. editor exactly the way it is, it will not be necessary to use the
  2731. configuration program.
  2732.  
  2733. The configuration program is QCONFIG.EXE and is included on the
  2734. distribution diskette, along with the other QEdit software. The
  2735. configuration program customizes QEdit by actually modifying the
  2736. editor program itself - Q.EXE.
  2737.  
  2738. +---------------------------------+
  2739. | QEdit Tip:                      |
  2740. |   Before running the            |
  2741. |   configuration program, make   |
  2742. |   a backup copy of the original |
  2743. |   QEdit distribution disk.      |
  2744. +---------------------------------+
  2745.  
  2746. Initiating the Configuration Program
  2747. ====================================
  2748.  
  2749. To initiate the configuration program, type "qconfig <Enter>" from
  2750. the DOS command line.  The program will request the name of the
  2751. editor program to customize with the prompt:
  2752.  
  2753. +-------------------------------------------------------+
  2754. |   Enter program name to config, <CR> for Q.EXE :      |
  2755. +-------------------------------------------------------+
  2756.  
  2757. Simply press <Enter>, unless you have previously renamed the
  2758. editor or if the editor is located in another directory.
  2759.  
  2760. If you have renamed the editor, enter the appropriate filename and
  2761. press <Enter>.  If the editor is located in another directory,
  2762. enter the full pathname and press <Enter>.
  2763.  
  2764.  
  2765. If the file to be customized could not be located on disk, this
  2766. error message will be displayed:
  2767. +--------------------------------------------------+
  2768. |FATAL ERROR: Q.EXE not found                      |
  2769. +--------------------------------------------------+
  2770.  
  2771. Check the editor's filename and/or path for accuracy.
  2772.  
  2773.  2-2
  2774.  
  2775. If the version numbers of the editor and the configuration program
  2776. are not the same, this error message will be displayed:
  2777.  
  2778. +--------------------------------------------------+
  2779. |FATAL ERROR: patch area not found                 |
  2780. +--------------------------------------------------+
  2781.  
  2782. Try reloading the QEdit software from the distribution disk
  2783. (i.e., Q.EXE and QCONFIG.EXE).
  2784.  
  2785.  
  2786. The Configuration Menu
  2787. ======================
  2788.  
  2789. The configuration program will display a menu from which to select
  2790. the desired functions for customization.
  2791.  
  2792. +--------------------------------------------------------------+
  2793. |  Configuration choices.                                      |
  2794. |  Choose One of the Following by pressing the indicated Key:  |
  2795. |                                                              |
  2796. |  A)dvanced options                                           |
  2797. |  C)olors/screen                                              |
  2798. |  G)eneral options                                            |
  2799. |  H)elp install                                               |
  2800. |  K)eys                                                       |
  2801. |  P)rinter options                                            |
  2802. |  Q)uit                                                       |
  2803. |  S)ave changes and quit                                      |
  2804. |  T)ab settings                                               |
  2805. +--------------------------------------------------------------+
  2806.  
  2807. Following is a brief explanation of these menu items.  They will
  2808. each be discussed in detail in this chapter.  (See Appendix E for
  2809. additional options.)
  2810.  
  2811. A)dvanced options
  2812.     Contains a variety of configurable options, including those
  2813.     related to video display, DOS memory, and editor menus.
  2814.  
  2815. C)olors/screen
  2816.     Allows you to change colors of various editor displays when
  2817.     using a color monitor.
  2818.  
  2819. G)eneral options
  2820.     A miscellaneous category of options.
  2821.  
  2822. H)elp install
  2823.     Allows you to create your own Help Screen.
  2824.  
  2825.  2-3
  2826.  
  2827. K)eys
  2828.     Allows you to reassign editor commands to different keys.
  2829.  
  2830. P)rinter options
  2831.     Allows you to set options for printing text, such as page size.
  2832.  
  2833. Q)uit
  2834.     Terminates the program.  You will first be prompted to save or
  2835.     not to save changes.
  2836.  
  2837. S)ave changes and quit
  2838.     After you have made all of the desired changes, press <S> to
  2839.     save the changes and terminate the program.
  2840.  
  2841. T)ab settings
  2842.     Allows you to set the physical and cursor tab widths.
  2843.  
  2844.  
  2845. Choose the category that you wish to customize by pressing the first
  2846. letter of the corresponding menu item.  You will be prompted for a
  2847. response to each option within the category.  Each configuration
  2848. option will be displayed along with its current value.  (The Keys
  2849. and Help install categories, however, work a little differently in
  2850. that they request a filename.)
  2851.  
  2852. For each option displayed, you may enter a new value. If you do not
  2853. wish to change the current value, simply press <Enter>.  After you
  2854. have reviewed all options in a category, you will be returned to
  2855. the main menu where you may select another category.
  2856.  
  2857. Once you have completed customizing, you may save all the changes
  2858. you have made by pressing <S> at the main menu prompt.  Your changes
  2859. will be made permanent (that is, effective the next time you execute
  2860. the editor), and the configuration program will be terminated.
  2861.  
  2862. If you decide that you do not want to save your changes, press <Q>. 
  2863. The prompt "Save Changes (Y/N)?" will be displayed.  Simply press 
  2864. <N>.  No changes will be saved and the configuration program will be
  2865. terminated.
  2866.  
  2867.  2-4
  2868.  
  2869. Advanced Options
  2870. ================
  2871.  
  2872. This section contains a list of the Advanced Options which can be
  2873. customized using the configuration program. The configuration
  2874. program prompt, the default value, and a description are given for
  2875. each option.
  2876.  
  2877. - Test for presence of EGA or VGA adapters (Y/N)? [Y] :
  2878.     For Concurrent PC-DOS (a Digital Research version of DOS) users
  2879.     only, this option should be set to <N>.
  2880.  
  2881. - Test for presence of enhanced keyboard (Y/N)? [N] :
  2882.     If your system has an enhanced (101 key) keyboard then set this
  2883.     option to <Y> and QEdit will recognize the additional keys such
  2884.     as F11, F12, and grey cursor keys.
  2885.  
  2886. +--------------------------------------------------+
  2887. | QEdit Tip:                                       |
  2888. |   Many TSR's, including mouse drivers, do not    |
  2889. |   properly recognize the enhanced keyboard.  If  |
  2890. |   you are using a TSR and it is not working with |
  2891. |   QEdit, try setting this option to <N>.         |
  2892. +--------------------------------------------------+
  2893.  
  2894. - Should QEdit change the cursor size (Y/N)? [Y] :
  2895.     By default, QEdit uses a small cursor when Insert mode is OFF
  2896.     and a medium cursor when Insert mode is ON.  Selecting <N> will
  2897.     tell QEdit not to change the cursor size.
  2898.  
  2899. - Do you want the Return command to split lines in insert mode
  2900.   (Y/N)? [Y] :
  2901.     Normally, the Return command splits the current line at the
  2902.     cursor when pressed in Insert mode. This means that the part of
  2903.     the line following the cursor will be inserted on a new line. If
  2904.     Insert mode is OFF, the Return command will simply place the
  2905.     cursor at the beginning of the next line.
  2906.  
  2907.     If you select <N> for this option, the Return command will 
  2908.     always act as if Insert mode is OFF. Return will move the cursor 
  2909.     to the beginning of the next line with no effect on the text.
  2910.  
  2911.  2-5
  2912.  
  2913. - Should Cut and Copy use current line if no block marked(Y/N)? [N]:
  2914.     If a block is not marked, and you execute the Cut or Copy
  2915.     command, the current cursor line will be affected if you enter
  2916.     <Y> for this option.
  2917.  
  2918. - Amount of memory to reserve from DOS (in paragraphs)
  2919.   [0,8..32767]  [0] :
  2920.     COMMAND.COM normally occupies the high end of DOS memory. If a
  2921.     program uses all available DOS memory, then COMMAND.COM can be
  2922.     overlayed and will have to be reloaded when the application is
  2923.     finished.  This really is not a problem on a hard disk system,
  2924.     as the reload takes a very short time.  On a diskette based
  2925.     system, the delay can be somewhat annoying.  Specifying a value
  2926.     of 1400 should keep COMMAND.COM from having to be reloaded on
  2927.     any DOS version through 3.3.  Please note that this will deny
  2928.     QEdit of an additional 22k of memory.
  2929.  
  2930. - Code generated by ALT numeric keypad  [0] :
  2931.     The <Alt> numeric keypad can be used to enter just about any of
  2932.     the characters in the IBM PC character set.  Characters are
  2933.     entered by holding down the <Alt> key and pressing the decimal
  2934.     number(s) that represents that character.  On IBM PC's this
  2935.     action returns a scan code of 0.  A small number of compatible
  2936.     PC's return a different scan code.  If your PC returns a
  2937.     different scan code for the <Alt> numeric keypad, enter it here.
  2938.  
  2939. - Do you want the ESCAPE command to invoke the menus (Y/N)? [Y] :
  2940.     By default, the Escape command displays the "Pop-Down" menus,
  2941.     when executed outside of the menus or any QEdit prompts.  If you
  2942.     do NOT want the Escape command to do this, select <N> for this
  2943.     option.
  2944.  
  2945.  2-6
  2946.  
  2947. Colors/Screen Options
  2948. =====================
  2949.  
  2950. This section contains a list of the Screen and Screen Color Options
  2951. which can be customized using the configuration program. The
  2952. configuration program prompt, the default value, and a description
  2953. are given for each option.
  2954.  
  2955. - Statusline position: "T" for top, "B" for bottom  [T] :
  2956.     The Status Line may be positioned at the top or at the bottom
  2957.     line of the screen.
  2958.  
  2959. - Statusline fill character [ ] :
  2960.     This character is used to "break up" the information on the
  2961.     editor's Status Line.  The default is a space.  For example,
  2962.     if the dash character is specified then the Status Line would
  2963.     look like this:
  2964.  
  2965. +-----------------------------------------------------------+
  2966. |L 15-- C 15---IAW-R-B--411K-----*c:\qedit\qedit.doc--------|
  2967. +-----------------------------------------------------------+
  2968.  
  2969. - Do you want the display "boxed" (Y/N)? [N] :
  2970.     The editing screen may be completely enclosed in a box.
  2971.  
  2972. - Do you want the original screen restored upon termination (Y/N)?[Y]:
  2973.     QEdit can optionally restore the original screen upon exiting
  2974.     the program.  Be aware that selecting this option takes up 4k of
  2975.     memory.  But it is very handy after long uninterrupted editing
  2976.     sessions to see what you were doing before you started.
  2977.  
  2978. - Do you want "snow" checking (Y/N)? [Y] :
  2979.     If QEdit determines that your system has a Color/Graphics
  2980.     Adapter card (CGA), the editor will not write to the screen at
  2981.     full speed in order to avoid "snow" (a sparkling appearance on
  2982.     the screen that results from updating the screen too quickly).
  2983.  
  2984.     If you have a COMPAQ, ZENITH, or other color adapter that allows
  2985.     full speed screen updating without "snow", then set this option
  2986.     to <N>.
  2987.  
  2988.     This option has no effect on monochrome and true EGA/VGA cards.
  2989.  
  2990. - Number of columns to scroll horizontally for screen lt/rt
  2991.   commands [1..400] [1] :
  2992.     This is the number of columns that QEdit should scroll when you
  2993.     enter the ScreenLeft or ScreenRight commands.
  2994.  
  2995.  2-7
  2996.  
  2997. +-----------------------------------------------------+
  2998. |Attribute chart/guide. [0..127]                      |
  2999. |                                                     |
  3000. |                                                     |
  3001. |              **    GRAPHIC CHART    **              |
  3002. |              **    OMITTED FROM     **              |
  3003. |              **  DOCUMENTATION FOR  **              |
  3004. |              **  SHAREWARE VERSION  **              |
  3005. |          (run QCONFIG to view color chart)          |
  3006. |                                                     |
  3007. |Select attributes from the chart above.              |
  3008. +-----------------------------------------------------+
  3009.  
  3010. The chart above is for use with the following Screen Color Options.
  3011. Enter a number, in response to each option, based on the color in
  3012. which the number appears on the chart.
  3013.  
  3014. If you have a monochrome screen, many of the values in the chart 
  3015. will appear to be the same color. However, you will still have the 
  3016. options of normal, highlighted, underlined, and reverse video. If 
  3017. you have a color monitor you can take advantage of a wider array of 
  3018. options.
  3019.  
  3020. - Blocked Text [112]:
  3021.     The color used for marked Blocks.
  3022.  
  3023. - Error msgs [112]:
  3024.     The color used for warning and error messages.
  3025.  
  3026. - Text Area [7]:
  3027.     The color used for normal text (the editing screen).
  3028.  
  3029. - Status Line [9]:
  3030.     The color used for the Status Line.
  3031.  
  3032. - Cursor Line [15]:
  3033.     The color used for the cursor line. Reverts to normal when a 
  3034.     block is marked.
  3035.  
  3036. - Messages [15]:
  3037.     The color used for QEdit messages.
  3038.  
  3039. - Hi-lited items [9]:
  3040.     The color used for "found" search strings when using the Find
  3041.     and FindReplace commands.
  3042.  
  3043. - EOF line/indicator [15]:
  3044.     The color used for the "end of file" line.
  3045.  
  3046.  2-8
  3047.  
  3048. - Help screen [112]:
  3049.     The color used for the Help Screen.
  3050.  
  3051. - Box borders [15]:
  3052.     The color used for box borders.
  3053.  
  3054. - PopUp windows [15]:
  3055.     The color used for the background of the "Pop-Down" menus.
  3056.  
  3057. - Menu items [15]:
  3058.     The color used for items within menus.
  3059.  
  3060. - Selected Menu items [112]:
  3061.     The color used for selected items within menus.
  3062.  
  3063.  
  3064. General Options
  3065. ===============
  3066.  
  3067. This section contains a list of the General Options which can be
  3068. customized using the configuration program.  The configuration
  3069. program prompt, the default value, and a description are given for
  3070. each option.  (See Appendix E for additional options.)
  3071.  
  3072. - Do you want the DelCh command to join lines if at EOL (Y/N)? [Y] :
  3073.     If you want the DelCh command to be restricted so that it only
  3074.     works on the current line, then select <N> for this option.  If
  3075.     you select <Y>, the command will work across line breaks.  This
  3076.     means that if you issue DelCh at the end of the line, the
  3077.     following line will be joined to the end of the cursor line
  3078.     (just as if you had issued a JoinLine command).
  3079.  
  3080. - Do you want the PQuit, Exit, and File commands to return to
  3081.   "EditFile" prompt (Y/N)? [Y] :
  3082.     If only 1 file is being edited, QEdit can either terminate or
  3083.     ask for another file to edit whenever the PQuit, Exit, or File
  3084.     commands are executed.  Enter <N> to terminate.
  3085.  
  3086. - Do you want the editor to start in Wordwrap Mode (Y/N)? [N] :
  3087.     If you want WordWrap mode to be ON each time QEdit is executed,
  3088.     then set this option to <Y>.  Refer to the "Word Processing
  3089.     Commands" section of Chapter 1 for more information on WordWrap.
  3090.  
  3091. - Default right margin for Wordwrap [1..512] [60] :
  3092.     This is the default right margin setting each time QEdit is
  3093.     executed.  Refer to the "Word Processing Commands" section of
  3094.     Chapter 1 for more information.
  3095.  
  3096.  2-9
  3097.  
  3098. - Do you want the editor to start in Insert Mode (Y/N)? [Y] :
  3099.     If you want Insert mode to be ON each time QEdit is executed,
  3100.     then set this option to <Y>.  Refer to the "Modes" section of
  3101.     Chapter 1 for more information on Insert mode.
  3102.  
  3103. - Do you want the editor to start in Autoindent Mode (Y/N)? [Y] :
  3104.     If you want AutoIndent mode to be ON each time QEdit is
  3105.     executed, then set this option to <Y>.  Refer to the "Modes"
  3106.     section of Chapter 1 for more information on AutoIndent mode.
  3107.  
  3108. - Load wildcarded filespecs from the command line (Y/N)? [Y] :
  3109.     When QEdit encounters a wildcarded file specification (* or ?)
  3110.     from the DOS command line, it will do one of two things
  3111.     depending on this option setting.  If you select <Y>, the editor
  3112.     will load every file that matches the wildcarded specification.
  3113.     (For example, if you entered "q *.doc", QEdit would load all
  3114.     files with the extension ".doc"). However, if you select <N>,
  3115.     QEdit will display a "Pop-Down" menu list of all the files which
  3116.     match the wildcarded specification. You can then choose the file
  3117.     you want to edit by using the cursor keys and pressing <Enter>.
  3118.  
  3119. - Load wildcarded filespecs from inside the editor (Y/N)? [N] :
  3120.     This option is similar to the previous one, except that it 
  3121.     refers to the EditFile command rather than the DOS command line 
  3122.     used at startup.  If you use a wildcard character with EditFile 
  3123.     it will either load all matching files, or show you a list of 
  3124.     matching files, depending on your choice for this option. Select 
  3125.     <Y> to load all matching files and <N> to display a list of 
  3126.     matching files.
  3127.  
  3128. - Do you want the editor to start in "enter matching" mode (Y/N)?[N]:
  3129.     When ON, the double quote, parenthesis, and square bracket
  3130.     keys all automatically enter the matching character when the
  3131.     left character is entered.  For example, typing the '[' key
  3132.     automatically enters a ']' immediately following.
  3133.  
  3134. - Use CMODE for .c, .cpp, .cxx, .h, .hpp, and .hxx files (Y/N)? [Y]:
  3135.     C mode is included primarily for editing C Language programs.  C
  3136.     mode is only in effect when AutoIndent mode is also ON.  When C
  3137.     mode is active, <Enter> typed on a line containing a '{' does a
  3138.     normal return and then issues a TabRt command.  Subsequently,
  3139.     when a '}' is typed, a TabLt command is issued.
  3140.  
  3141. - Default number of deleted lines to keep per file [0..300] [30] :
  3142.     QEdit saves a certain number of deleted lines and blocks, which
  3143.     can later be recalled using the UnKill command.  This option
  3144.     allows you to select the maximum number of lines QEdit can save
  3145.     for every edited file.
  3146.  
  3147.  2-10
  3148.  
  3149. - Remove trailing blanks from edited lines (Y/N)? [Y] :
  3150.     When you edit a line of text, QEdit can either remove trailing
  3151.     blanks from that line or leave it as is.  For most purposes,
  3152.     the remove option is preferable, as it will generally create
  3153.     smaller files.
  3154.  
  3155. - Delete white space after words with DelRtWord command (Y/N)? [Y] :
  3156.     If you enter the DelRtWord command, it deletes the "word" to the
  3157.     right of the cursor.  This option causes DelRtWord to
  3158.     delete the blank space which follows the word as well.
  3159.  
  3160. - Terminate files with a Control Z (Y/N)? [N] :
  3161.     MS/PC-DOS versions 2.0 thru 3.3 do NOT require an end of file
  3162.     terminator (the exact size of the file is stored in the
  3163.     directory).  However, some programs that were directly
  3164.     translated from their CP/M versions still require the Control Z
  3165.     end of file marker.  If you have one of these programs for which
  3166.     you are creating text files, you should select <Y> for this
  3167.     option.
  3168.  
  3169. - Do you want "backups" of saved files (Y/N)? [Y] :
  3170.     Select <Y> if you want a backup file (an image of the file
  3171.     before you did any editing) with the .bak extension saved each
  3172.     time you save a file.
  3173.  
  3174. - Prompt for filename on open window (Y/N)? [N] :
  3175.     If you enter the HorizontalWindow command, QEdit can either
  3176.     prompt you for the name of the file you want to load into the
  3177.     new window or load the next file in the ring into the new
  3178.     window (in the latter case, if only one file is being edited
  3179.     another window for the same file is opened).
  3180.  
  3181.     To have QEdit prompt you for a filename, select <Y>.  To have it
  3182.     load the next file in the ring, select <N>.
  3183.  
  3184. - Close window when a file is quit (Y/N)? [Y] :
  3185.     If you enter any command which discards a file from the editor
  3186.     whenever more than one window is open, QEdit can either load
  3187.     the next file in the ring into that window or close that
  3188.     window.
  3189.  
  3190.     To have QEdit close the window, select <Y>.  To have it load the
  3191.     next file in the ring, select <N>.
  3192.  
  3193. - Display End Of File marker (Y/N)? [Y] :
  3194.     QEdit can optionally display a line at the end of the file in
  3195.     the following format:
  3196.  
  3197.           <*** End of File ***>
  3198.  
  3199.  2-11
  3200.  
  3201. - Insert line blocks ABOVE the cursor line (Y/N)? [N] :
  3202.     Line blocks can either be inserted (with the Paste, CopyBlock,
  3203.     or MoveBlock command) above or below the current cursor line.
  3204.  
  3205. - Default Find options [IWBG] [I]:
  3206.     Select the default search options when using the Find command.
  3207.     The options are:
  3208.  
  3209.     I - Ignore Case.  The Find command will ignore lower and upper
  3210.         case when searching for a matching string.
  3211.  
  3212.     W - Words Only.  The Find command will search for matching
  3213.         strings which are whole words only.  For example, with the
  3214.         "W" option on, searching for the string "not", QEdit would
  3215.         ignore strings such as "cannot", "notes", etc. and only
  3216.         identify occurrences of the string "not" delimited by
  3217.         spaces.
  3218.  
  3219.     B - Backwards Search.  This option causes the Find command to
  3220.         begin with the current cursor position and search backwards
  3221.         toward the beginning of the file.
  3222.  
  3223.     G - Global Search. Begin searching from the beginning of the 
  3224.         file.
  3225.  
  3226.     Note that even when these options are not selected as defaults,
  3227.     they can still be selected from within the editor whenever the
  3228.     Find command is executed.
  3229.  
  3230. - Default FindReplace options [IWBNG] [I]:
  3231.     Select the default search and replace options when using the
  3232.     FindReplace command.  The options are:
  3233.  
  3234.     I - Ignore Case.  The FindReplace command will ignore lower and
  3235.         upper case when searching for a matching string.
  3236.  
  3237.     W - Words Only.  The FindReplace command will search for
  3238.         matching strings which are whole words only.  For example,
  3239.         with the "W" option on, searching for the string "not",
  3240.         QEdit would ignore strings such as "cannot", "notes", etc.
  3241.         and only identify occurrences of the string "not" delimited
  3242.         by spaces.
  3243.  
  3244.     B - Backwards Search.  This option causes the FindReplace
  3245.         command to begin with the current cursor position and search
  3246.         backwards toward the beginning of the file.
  3247.  
  3248.     N - No Prompting.  The FindReplace command will not prompt when
  3249.         it identifies a matching string; instead, all occurrences of
  3250.         the search string will be replaced with the new string.
  3251.  
  3252.     G - Global Search. Begin searching from the beginning of the 
  3253.         file.
  3254.  
  3255.  2-12
  3256.  
  3257.     Note that even when these options are not selected as defaults,
  3258.     they can still be selected from within the editor whenever the
  3259.     FindReplace command is executed.
  3260.  
  3261. - Default file extension number 1 [.pas]:
  3262.  
  3263. - Default file extension number 2 [.inc]:
  3264.  
  3265. - Default file extension number 3 [.asm]:
  3266.  
  3267. - Default file extension number 4 [.c]:
  3268.  
  3269. - Default file extension number 5 [.h]:
  3270.  
  3271. - Default file extension number 6 [.doc]:
  3272.  
  3273.     Six default file extensions are provided to save keystrokes each
  3274.     time a filename to edit is entered.  These file extensions are
  3275.     used whenever QEdit is executed with a filename from the command
  3276.     line or whenever the EditFile command is entered.
  3277.  
  3278.     When using QEdit, if the filename entered does not have a period
  3279.     (and does not include the DOS wildcard characters) and that
  3280.     file does NOT exist as named, QEdit appends the first default
  3281.     file extension to the name and tries to load that file.  If that
  3282.     file exists, then QEdit loads it for editing.  If it does not
  3283.     exist, QEdit will repeat the process with the other default file
  3284.     extensions.  If no files were found, then QEdit will create a
  3285.     new file as originally named.
  3286.  
  3287.  
  3288. The Help Screen
  3289. ===============
  3290.  
  3291. QEdit allows you to create a customized one page Help Screen, which
  3292. may be displayed at any time from within the editor by entering the
  3293. QuickHelp <F1> command.
  3294.  
  3295. Of course, you may prefer to use the default Help Screen which is
  3296. already loaded into QEdit.  In that case no action is required.
  3297. However, if you want to design and use your own Help Screen, simply
  3298. follow these steps:
  3299.  
  3300. 1. Create an 80 x 25 (80 columns by 25 lines) text file (you can use
  3301.    QEdit to create this file) and list all of the information that
  3302.    should appear on the screen when the QuickHelp command is
  3303.    entered.  We suggest that you list less frequently used commands
  3304.    in this file, while leaving out more familiar commands such as
  3305.    cursor movement and paging.
  3306.  
  3307.  2-13
  3308.  
  3309. 2. Run QCONFIG.EXE and select option <H> from the menu.
  3310.  
  3311. 3. You will be prompted for the name of the Help file just created.
  3312.    Enter that name.
  3313.  
  3314. That is all there is to it!  The next time you enter QuickHelp from
  3315. within QEdit, your customized Help Screen will be displayed.
  3316.  
  3317.  
  3318. Keyboard Configuration
  3319. ======================
  3320.  
  3321. QEdit provides the extremely helpful capability of assigning editor
  3322. commands (and strings of characters) to almost any key you prefer.
  3323.  
  3324. This allows you to assign frequently used commands to keys which are
  3325. most convenient for your use or you may wish to reassign commands
  3326. completely to emulate another text editor or word processor with
  3327. which you are already familiar.
  3328.  
  3329. By taking a few minutes to review this section, your future text
  3330. editing may become significantly smoother and more comfortable as a
  3331. result of customizing your keyboard to suit your individual
  3332. preferences.
  3333.  
  3334.  
  3335. The Keyboard Definition File
  3336.  
  3337. QEdit uses the Keyboard Definition file to customize the keyboard.
  3338. This file contains a list of all the keys to which commands may be
  3339. assigned.  Supplied with QEdit is a Keyboard Definition file called
  3340. QCONFIG.DAT which contains the default settings for the keyboard.
  3341. Other files are supplied which emulate certain common word
  3342. processors.  WordStar command keys can be emulated using the
  3343. WSKEY.DAT Keyboard Definition file.  Brief command keys can be
  3344. emulated using the BRIEF.DAT Keyboard Definition file.
  3345.  
  3346. The Keyboard Definition file consists of a list of configurable keys
  3347. and the commands or macros which are assigned to them.  The
  3348. configurable keys are on the left side of the file with the commands
  3349. or macros assigned to the keys on the right.  Blank lines and lines
  3350. starting with an asterisk "*" are ignored. The QCONFIG.DAT file, as
  3351. well as Appendix B, contains a complete list of configurable keys.
  3352.  
  3353. Control keys are specified with a "^".  For example:
  3354.  
  3355.    ^f1 or ^F1 specifies Control F1
  3356.    ^c  or ^C  specifies Control C
  3357.    ^PgUp      specifies Control PgUp
  3358.  
  3359.  2-14
  3360.  
  3361. Alternate keys are specified with a "@".  For example:
  3362.  
  3363.    @f1 or @F1 specifies Alt F1
  3364.    @c  or @C  specifies Alt C
  3365.    @PgUp      specifies Alt PgUp
  3366.  
  3367. Shift keys are specified with a "#".  For example:
  3368.  
  3369.    #f1 or #F1 specifies Shift F1
  3370.  
  3371. The format of a line in the Keyboard Definition file is simply the
  3372. keystroke followed by the command.  For example:
  3373.  
  3374.    f1                      QuickHelp
  3375.    #f5                     MakeCtrofScreen
  3376.    @f2                     InsertLine
  3377.    cursorup                CursorUp
  3378.    ^cursorleft             WordLeft
  3379.    backspace               Backspace
  3380.    ^backspace              DelLtWord
  3381.    @a                      DropAnchor
  3382.    ^a                      WordLeft
  3383.  
  3384. +-------------------------------------------------+
  3385. | QEdit Tip:                                      |
  3386. |   The configuration program ignores the case of |
  3387. |   the command, as well as any underscores that  |
  3388. |   may be embedded.  This means that InsertLine, |
  3389. |   insert_line, and Insert_Line all refer to the |
  3390. |   same command.                                 |
  3391. |                                                 |
  3392. |   Also, the order of the keys does not matter.  |
  3393. |   The configurable keys may be put in any order |
  3394. |   desired.                                      |
  3395. +-------------------------------------------------+
  3396.  
  3397. There is also a provision for assigning commands to a "twokey". A
  3398. twokey consists of two distinct keystrokes, such as <Ctrl B>
  3399. immediately followed by <A>.  To assign a command to a twokey, enter
  3400. both keystrokes of the twokey in the first column (keystroke column)
  3401. separated by an underline.
  3402.  
  3403. For example, to assign the Exit command to the twokey,
  3404. <Ctrl F1> <F2>, enter the following into the Keyboard Definition
  3405. file:
  3406.  
  3407.    ^f1_f2     Exit
  3408.  
  3409.  2-15
  3410.  
  3411. Through the use of macros, multiple commands and/or text may be
  3412. assigned to any configurable key (Macros, however, cannot be
  3413. assigned to twokeys).  To define a macro, specify MacroBegin as the
  3414. first command, followed by any combination of text and QEdit
  3415. commands, each separated by a space.  Text should be enclosed in
  3416. single or double quotes.  The commands and/or text must all fit on
  3417. one line, not exceeding 255 characters in length.
  3418.  
  3419. Example:
  3420.  
  3421.    f1  MacroBegin EditFile 'help.dat' Return
  3422.  
  3423. This macro would load the file 'help.dat'.  Note that the Return
  3424. command is issued after the text.  This is required to terminate the
  3425. QEdit prompt.
  3426.  
  3427. Example:
  3428.  
  3429.    @t  MacroBegin GSave Dos 'tpc ' CurrentFilename Return
  3430.  
  3431. Now, when you press <Alt T>, all changed files will be saved and the
  3432. Turbo Pascal compiler will be invoked on the current file.
  3433.  
  3434. Example (the following must appear on 1 line in the Keyboard
  3435. Definition file):
  3436.  
  3437.    @f1   MacroBegin EditFile 'errors.lst' Return Quit Dos
  3438.          'tcc ' CurrentFilename ' >errors.lst' Return Return
  3439.          HorizontalWindow EditFile 'errors.lst' Return
  3440.  
  3441. This macro will run the Turbo C compiler on the current file, saving
  3442. the results to a file called "errors.lst", and loading that file
  3443. into another window after the compile is finished.
  3444.  
  3445. Additional examples can be found in Appendix D.  In general, any
  3446. commonly used sequence of commands (or a useful, but complicated
  3447. sequence of commands for that matter) is a good candidate for a
  3448. macro.
  3449.  
  3450.  
  3451. Creating a Keyboard Definition File
  3452.  
  3453. To customize the keyboard using the default Keyboard Definition
  3454. file, QCONFIG.DAT, no action is required.  QEdit is distributed with
  3455. this Keyboard Definition file already loaded.
  3456.  
  3457.  2-16
  3458.  
  3459. To customize the keyboard using one of the supplied word processor
  3460. emulation Keyboard Definition files, skip to step number 6 below.
  3461.  
  3462. To create your own Keyboard Definition file, do the following:
  3463.  
  3464. 1. Load the file QCONFIG.DAT into QEdit (from the DOS command line
  3465.    type "q qconfig.dat <Enter>").
  3466.  
  3467. 2. Rename the file using the ChangeFilename command <Alt O>.
  3468.  
  3469. 3. Browse through the file using the Cursor Up and Down keys. Notice 
  3470.    that the left side of the file contains a list of all configurable 
  3471.    keys.  To the right of each key is the command or macro currently 
  3472.    assigned to the key.  Some keys have no commands assigned.
  3473.  
  3474. 4. Change the commands assigned to the keys to suit your particular
  3475.    needs.  For more information on how to assign keys, refer to The
  3476.    Keyboard Definition file section above.
  3477.  
  3478. 5. Save the file and exit QEdit by pressing <Alt X>.
  3479.  
  3480. 6. Run QCONFIG.EXE and select option <K> from the menu.
  3481.  
  3482. 7. You will be prompted for the name of the Keyboard Definition
  3483.    file.  Enter the name of the Keyboard Definition file you wish to
  3484.    load.  If you are creating your own file, enter the new name
  3485.    chosen in step 2.
  3486.  
  3487. 8. Your key assignments will be incorporated into the editor
  3488.    program, Q.EXE.  The QCONFIG menu will again appear. Press <S> to
  3489.    save your changes and terminate the program.
  3490.  
  3491. 9. Run the editor to insure that your key assignments function as
  3492.    desired.
  3493.  
  3494.  
  3495. Printer Options
  3496. ===============
  3497.  
  3498. This section contains a list of the Printer Options which can be
  3499. customized using the configuration program.  The configuration
  3500. program prompt, the default value, and a description are given for
  3501. each option.  (See Appendix E for additional options.)
  3502.  
  3503. - Default left margin for printing [0..80] [0]:
  3504.     This is the number of spaces QEdit skips before printing each
  3505.     line. If you do not want QEdit to skip any spaces at the
  3506.     beginning of each line, select zero.
  3507.  
  3508. - Default page size for printing [0..400] [0]:
  3509.     QEdit will send a formfeed character to the printer after
  3510.     printing this number of lines.  If you do NOT want QEdit
  3511.     to send formfeeds (continuous printing), select zero.
  3512.  
  3513.  2-17
  3514.  
  3515. - Add formfeed after printing (Y/N)? [Y] :
  3516.     Should QEdit send a formfeed when printing is complete?  If you
  3517.     select <Y>, your forms should be correctly lined up in
  3518.     preparation for the next printing operation.
  3519.  
  3520.  
  3521. Tab Settings
  3522. ============
  3523.  
  3524. This section contains a list of all Tab Setting Options which can be
  3525. customized using the configuration program.  The configuration
  3526. program prompt, the default value, and a description are given for
  3527. each option.
  3528.  
  3529.  
  3530. - Do you want the editor to start in Physical Tab Expansion Mode 
  3531.   (Y/N)?[Y]:
  3532.     If you want Physical Tab Expansion mode to be ON each time QEdit 
  3533.     is executed, then set this option to <Y>.  Refer to the "Modes" 
  3534.     section of Chapter 1 for more information on Physical Tab 
  3535.     Expansion.
  3536.  
  3537. - Do you want the editor to start in Tabs Out Mode (Y/N)? [N] :
  3538.     If you want Tabs Out mode to be ON each time QEdit
  3539.     is executed, then set this option to <Y>.  Refer to the "Modes"
  3540.     section of Chapter 1 for more information on Tabs Out.
  3541.  
  3542. - Default physical tab width [2,4, or 8] [8]:
  3543.     This is the tab width that QEdit uses when Physical Tab 
  3544.     Expansion mode or Tabs Out mode are ON.
  3545.  
  3546. - Default Cursor tab width [2..12] [8]:
  3547.     This is the tab width that QEdit uses when you enter the TabRt
  3548.     and TabLt commands.
  3549.  
  3550. - Default file extension number 1 for default tabs [.pas]:
  3551.   Physical tab width for above [2]:
  3552.   Cursor tab width for above [2]:
  3553.  
  3554. - Default file extension number 2 for default tabs [.inc]:
  3555.   Physical tab width for above [2]:
  3556.   Cursor tab width for above [2]:
  3557.  
  3558. - Default file extension number 3 for default tabs [.asm]:
  3559.   Physical tab width for above [8]:
  3560.   Cursor tab width for above [8]:
  3561.  
  3562.  2-18
  3563.  
  3564. - Default file extension number 4 for default tabs [.c]:
  3565.   Physical tab width for above [4]:
  3566.   Cursor tab width for above [4]:
  3567.  
  3568. - Default file extension number 5 for default tabs [.h]:
  3569.   Physical tab width for above [4]:
  3570.   Cursor tab width for above [4]:
  3571.  
  3572. - Default file extension number 6 for default tabs [.doc]:
  3573.   Physical tab width for above [8]:
  3574.   Cursor tab width for above [8]:
  3575.  
  3576.     QEdit allows you to set default physical and cursor tab widths
  3577.     for up to six different file extensions.  When a file is loaded
  3578.     that matches one of these extensions, these defaults are used.
  3579.     Otherwise, the defaults set in the first two Tab Settings are
  3580.     used.
  3581.  
  3582. - Do you want the editor to start in Smart Tabs Mode (Y/N)? [N] :
  3583.     If you want Smart Tabs mode to be ON each time QEdit
  3584.     is executed, then set this option to <Y>.  Refer to the "Modes"
  3585.     section of Chapter 1 for more information on Smart Tabs.
  3586.  
  3587.  2-19
  3588.  
  3589. CHAPTER 3.  QEDIT COMMAND REFERENCE_________________________________
  3590.  
  3591. This chapter contains a description for each of the QEdit commands.
  3592. Where appropriate, the default key assignments are provided.
  3593. Additionally, <Esc> sequences are given for those commands which can
  3594. be accessed through the "Pop-Down" menus.
  3595.  
  3596. To assign commands which do not have a default assignment or to
  3597. change existing key assignments, refer to the "Keyboard
  3598. Configuration" section of Chapter 2 for instructions.
  3599.  
  3600.  
  3601. AddLine             <F2> or <Esc><E><A>
  3602. ----------------------------------------
  3603.  
  3604. Adds a blank line after the cursor line, placing the cursor on the
  3605. newly created line.  The cursor column does not change.
  3606.  
  3607.  
  3608. Align
  3609. ----------------------------------------
  3610.  
  3611. Aligns the text on the cursor line with the text on the line
  3612. immediately before the cursor line and then positions the cursor on
  3613. the next line.  The cursor column does not change.  If the cursor is
  3614. on line one, or the previous line is blank, or the cursor line is
  3615. blank, this command will only move the cursor to the next line.
  3616.  
  3617.  
  3618. AppendScrbuff       <Ctrl BA>
  3619. ----------------------------------------
  3620.  
  3621. Appends the currently marked Block to the end of the named Scratch
  3622. Buffer.  The existing contents of the named Scratch Buffer are not
  3623. lost. If the named Scratch Buffer does not exist, a new Scratch
  3624. Buffer will be created.
  3625.  
  3626.  
  3627. Backspace           <Backspace>
  3628. ----------------------------------------
  3629.  
  3630. If Insert mode is ON:
  3631.  Deletes the character to the left of the cursor.  The text to the
  3632.  right of, and including the cursor position, shifts left one
  3633.  position. If the cursor is in column one, the cursor line is
  3634.  appended to the end of the preceding line.
  3635.  
  3636. If Insert mode is OFF:
  3637.  Deletes the character to the left of the cursor.  The text to the
  3638.  right of the cursor does NOT close in or shift.  If the cursor is
  3639.  in column one, however, the cursor line will still be appended to
  3640.  the end of the previous line.
  3641.  
  3642.  3-2
  3643.  
  3644. BegFile             <Ctrl PgUp>
  3645. ----------------------------------------
  3646.  
  3647. Positions the cursor at column one on the first line of the current
  3648. file.
  3649.  
  3650.  
  3651. BegLine             <Home>
  3652. ----------------------------------------
  3653.  
  3654. Positions the cursor at column one of the current cursor line.
  3655.  
  3656.  
  3657. BegScreen           <Ctrl Home>
  3658. ----------------------------------------
  3659.  
  3660. Positions the cursor at the top line of the current window.  The
  3661. cursor column does not change.
  3662.  
  3663.  
  3664. ChangeFilename      <Alt O> or <Alt F><C> or <Esc><F><C>
  3665. ----------------------------------------
  3666.  
  3667. Changes the name of the current file.  QEdit will prompt for the new
  3668. name.  If the file already exists, you will be required to confirm
  3669. that you still want to rename the file.  The current file is marked
  3670. as being a changed file.  (An asterisk will appear on the Status
  3671. Line preceding the filename.)  This command will have no effect on
  3672. disk files, until the renamed file is saved.
  3673.  
  3674.  
  3675. CloseWindow         <Ctrl OC> or <Esc><W><C>
  3676. ----------------------------------------
  3677.  
  3678. Closes the current window, unless it is the only window which is
  3679. open, in which case the command has no effect.
  3680.  
  3681.  
  3682. Copy                <grey +>
  3683. ----------------------------------------
  3684.  
  3685. Copies the marked Block into the Scrap Buffer.  The Block is then
  3686. unmarked.  If no Block is marked, the cursor line is copied into the
  3687. Scrap Buffer.  The copying of the cursor line, when a Block is not
  3688. marked, is configurable.  Refer to the "Advanced Options" section of
  3689. Chapter 2 for more information.
  3690.  
  3691.  
  3692. CopyBlock           <Alt C> or <Esc><B><C>
  3693. ----------------------------------------
  3694.  
  3695. Copies the marked Block to the cursor position.  If the Block is a
  3696. character Block (created using the DropAnchor, MarkCharacter, or
  3697. MarkBlockBegin/End commands)
  3698.  
  3699.  3-3
  3700.  
  3701. or a column Block (created using the MarkColumn command), the Block
  3702. is inserted into the text beginning at the current cursor position.
  3703. If the Block is a line Block (created using the MarkLine command),
  3704. it is inserted before or after the current cursor line, depending on
  3705. the configuration setting (Refer to the "General Options" section of
  3706. Chapter 2 for more information).  The Block remains marked.  Blocks
  3707. may be copied from one file to another.
  3708.  
  3709.  
  3710. CopyOverBlock       <Alt Z>
  3711. ----------------------------------------
  3712. Copies the currently marked column Block and places it at the
  3713. current cursor position by overlaying existing text and without
  3714. shifting text to the right.  This command only works with column
  3715. Blocks.  The Block remains marked.  Blocks may be "copied over" from
  3716. one file to another.
  3717.  
  3718.  
  3719. CurrentFilename
  3720. ----------------------------------------
  3721.  
  3722. Returns the name of the currently edited file, as if it had been
  3723. typed at the keyboard.  This command is useful for manipulation of
  3724. files from within macros.
  3725.  
  3726.  
  3727. CursorDown          <Cursor Down>
  3728. ----------------------------------------
  3729.  
  3730. Moves the cursor downward in the file to the next line.
  3731.  
  3732.  
  3733. CursorLeft          <Cursor Left>
  3734. ----------------------------------------
  3735.  
  3736. Moves the cursor one character to the left.  When the cursor reaches
  3737. the left edge of the screen, it stops, unless the text has been
  3738. scrolled left, in which case the text scrolls right one position.
  3739.  
  3740.  
  3741. CursorRight         <Cursor Right>
  3742. ----------------------------------------
  3743.  
  3744. Moves the cursor one character to the right.  When the cursor
  3745. reaches the right end of the screen, the text starts scrolling left
  3746. until the cursor reaches the maximum line length.
  3747.  
  3748.  
  3749. CursorUp            <Cursor Up>
  3750. ----------------------------------------
  3751.  
  3752. Moves the cursor upward in the file to the previous line.
  3753.  
  3754.  3-4
  3755.  
  3756. Cut                 <grey ->
  3757. ----------------------------------------
  3758.  
  3759. Copies the marked Block into the Scrap Buffer.  The Block is then
  3760. deleted from the file being edited.  If no Block is marked, the
  3761. cursor line is cut into the Scrap Buffer.  The cutting of the cursor
  3762. line, when a Block is not marked, is configurable.  Refer to the
  3763. "Advanced Options" section of Chapter 2 for more information.
  3764.  
  3765.  
  3766. DelCh               <Del>
  3767. ----------------------------------------
  3768.  
  3769. Deletes the character at the current cursor position.  The line to
  3770. the right of the cursor shifts left one position.  If the cursor
  3771. position is past the last character on the line, the next line is
  3772. appended to the cursor line.  The "joining" of the next line when
  3773. the cursor is past the last character on the line is configurable.
  3774. Refer to the "General Options" section of Chapter 2 for more
  3775. information.
  3776.  
  3777.  
  3778. DeleteBlock         <Alt G> or <Esc><B><D>
  3779. ----------------------------------------
  3780.  
  3781. Deletes the currently marked character or line Block.  If there is
  3782. not a Block marked in the current file, this command has no effect.
  3783.  
  3784.  
  3785. DelLine             <Alt D> or <Esc><E><D>
  3786. ----------------------------------------
  3787.  
  3788. Deletes the cursor line.  The line following the cursor line becomes
  3789. the new cursor line.
  3790.  
  3791.  
  3792. DelLtWord           <Ctrl Backspace>
  3793. ----------------------------------------
  3794.  
  3795. Deletes the "word" to the left of the cursor.  If the cursor is in
  3796. column one, the cursor line is appended to the end of the preceding
  3797. line.
  3798.  
  3799.  
  3800. DelRtWord           <Ctrl T>
  3801. ----------------------------------------
  3802.  
  3803. Deletes the "word" to the right of the cursor.  If the cursor
  3804. position is past the last character on the line, the next line is
  3805. appended to the cursor line.
  3806.  
  3807.  3-5
  3808.  
  3809. DelToEol            <F6> or <Esc><E><E>
  3810. ----------------------------------------
  3811.  
  3812. Deletes text on the cursor line, from the cursor position to the end
  3813. of line.
  3814.  
  3815.  
  3816. Dos                 <Alt F9>
  3817. ----------------------------------------
  3818.  
  3819. QEdit prompts for a command, which is passed to DOS for execution.
  3820. After the command is executed by DOS, control is returned to QEdit.
  3821. If you want to execute a series of commands in DOS, you should use
  3822. the Shell command, described later in this chapter.
  3823.  
  3824. +--------------------------------------------------------+
  3825. | QEdit Tip:                                             |
  3826. |   You should NOT execute any TSR (terminate and stay   |
  3827. |   resident) programs here. These include the DOS print |
  3828. |   and graph commands and memory-resident programs such |
  3829. |   as Sidekick and Superkey.                            |
  3830. +--------------------------------------------------------+
  3831.  
  3832.  
  3833. DropAnchor          <Alt A>
  3834. ----------------------------------------
  3835.  
  3836. This command is used to mark a character Block.  Initially executing
  3837. this command will mark one end of a Block at the cursor position.
  3838. As the cursor is moved, the Block will "grow" with it.  Executing
  3839. this command again will mark the other end of the Block at the
  3840. cursor position.  If DropAnchor is executed in a file that already
  3841. contains a character Block, the Block is extended to the current
  3842. cursor position.
  3843.  
  3844.  
  3845. DupLine             <F4>
  3846. ----------------------------------------
  3847.  
  3848. Makes a copy of the current cursor line and inserts the copy
  3849. immediately following the cursor line.  The cursor is moved to the
  3850. new line.
  3851.  
  3852.  
  3853. EditFile            <Alt E> or <Alt F><L> or <Esc><F><L>
  3854. ----------------------------------------
  3855.  
  3856. The editor prompts for the name(s) of the additional file(s) to be
  3857. edited.  Wildcard characters (* or ?) are permissible, as are
  3858. multiple filenames.  The editor will not load multiple copies of the
  3859. same file.  If you issue the EditFile command using the name of a
  3860. file that has already been loaded, QEdit will simply make that file
  3861. the current file.
  3862.  
  3863.  3-6
  3864.  
  3865. EndFile             <Ctrl PgDn>
  3866. ----------------------------------------
  3867.  
  3868. Positions the cursor on the last line of the file immediately
  3869. following the last non-blank character.  If the last line of the
  3870. file is blank, the cursor is positioned in column one.
  3871.  
  3872.  
  3873. EndLine             <End>
  3874. ----------------------------------------
  3875.  
  3876. Positions the cursor immediately following the last non-blank
  3877. character on the cursor line.
  3878.  
  3879.  
  3880. EndScreen           <Ctrl End>
  3881. ----------------------------------------
  3882.  
  3883. The cursor is positioned on the last line of the current window.  
  3884. The cursor column does not change.
  3885.  
  3886.  
  3887. Escape              <Esc>
  3888. ----------------------------------------
  3889.  
  3890. If executed while editing, the "Pop-Down" menus are displayed.
  3891. Otherwise, this command aborts any editor prompt.
  3892.  
  3893.  
  3894. ExecuteScrap        <Ctrl Enter>
  3895. ----------------------------------------
  3896.  
  3897. Plays back the latest macro that was created using the MacroRecord
  3898. command.
  3899.  
  3900.  
  3901. Exit                <Ctrl KD>
  3902. ----------------------------------------
  3903.  
  3904. Conditionally discards the current file.  If the file has not been
  3905. modified, the file is discarded without prompting.  If the file has
  3906. been modified, the editor prompts with "Save Changes (Y/N)?".
  3907. Pressing <Y> will save and then discard the file.  Pressing <N> will
  3908. discard the file without saving any changes.
  3909.  
  3910. QEdit can be configured, when only a single file is being edited and
  3911. the Exit command is issued, to either terminate or prompt for
  3912. another file to edit.  Refer to the "General Options" section of
  3913. Chapter 2 for more information.
  3914.  
  3915.  
  3916.  3-7
  3917.  
  3918. File                <Ctrl KX> or <Alt F><F> or <Esc><F><F>
  3919. ----------------------------------------
  3920.  
  3921. Saves and then discards the current file.
  3922.  
  3923. QEdit can be configured, when only a single file is being edited and
  3924. the File command is issued, to either terminate or prompt for
  3925. another file to edit.  Refer to the "General Options" section of
  3926. Chapter 2 for more information.
  3927.  
  3928.  
  3929. Find                <Ctrl QF> or <Esc><S><F>
  3930. ----------------------------------------
  3931.  
  3932. Searches for a specified string of characters within the current
  3933. file. The User is prompted for a search string and search options.
  3934. Available search options are:
  3935.   [B] Search backwards from the current cursor position.
  3936.   [G] Global search.  Begin searching from the beginning of the
  3937.       file (or marked block, if the L option is also selected.)
  3938.   [L] Local search.  Limit the search to the marked block.
  3939.   [I] Ignore the case of the search string.
  3940.   [W] Search for whole words only.
  3941.  
  3942.  
  3943. FindReplace         <Ctrl QA> or <Esc><S><R>
  3944. ----------------------------------------
  3945.  
  3946. Searches and replaces strings within the current file.  The User is
  3947. prompted for a search string, a replace string, and options.
  3948. Available options are:
  3949.   [B] Search backwards from the current cursor position.
  3950.   [G] Global search and replace. Begin searching from the beginning
  3951.       of the file (or marked block, if the L option is also 
  3952.       selected.)
  3953.   [L] Local search and replace.  Limit the search to the marked 
  3954.       block.
  3955.   [I] Ignore the case of the search string.
  3956.   [W] Search for whole words only.
  3957.   [N] Find and replace without prompting.
  3958.  
  3959. At every occurrence of the search string in the file, the User is
  3960. given the following replace options.
  3961.   [Y] Replace the search string with the replace string and
  3962.       continue on to the next occurrence of the search string.
  3963.   [N] Do not make any changes but continue on to the next
  3964.       occurrence of the search string.
  3965.   [O] Replace the search string with the replace string and
  3966.       then terminate the FindReplace process.
  3967.   [R] Replace the search string with the replace string for this
  3968.       and the rest of the occurrences throughout the file without
  3969.       any further prompting.
  3970.   [Q] Terminate the FindReplace process.
  3971.  
  3972.  3-8
  3973.  
  3974. GetPrev             <Ctrl - (dash)>
  3975. ----------------------------------------
  3976.  
  3977. Duplicates the character immediately above the cursor at the cursor
  3978. position.
  3979.  
  3980.  
  3981. GetScrbuff          <Ctrl BL>
  3982. ----------------------------------------
  3983.  
  3984. Inserts the contents of the named Scratch Buffer at the cursor
  3985. position. Refer to the "Block Commands" section of Chapter 1 for
  3986. more information.
  3987.  
  3988.  
  3989. GExit               <Alt X> or <Alt Q><X> or <Esc><Q><X>
  3990. ----------------------------------------
  3991.  
  3992. Issues the Exit command for all files that have been loaded.  If no
  3993. files have been modified, this command immediately terminates the
  3994. editor and returns control to DOS.  If any files have been modified
  3995. you are prompted with "Save Changes (Y/N)?" for each modified file.
  3996.  
  3997. For example, if you have ten files loaded and two of them have been
  3998. modified, then you will be prompted to save changes twice, once for
  3999. each modified file.
  4000.  
  4001.  
  4002. GFile               <Alt F><G> or <Esc><F><G>
  4003. ----------------------------------------
  4004.  
  4005. Instructs the editor to discard all files which have been loaded.
  4006. Any files which have been modified will be saved.
  4007.  
  4008. If no files have been changed, this command immediately terminates
  4009. the editor and returns control to DOS.
  4010.  
  4011.  
  4012. GotoBlockBeg        <Ctrl QB>
  4013. ----------------------------------------
  4014.  
  4015. Positions the cursor at the beginning of the currently marked Block.
  4016. If the Block is in a file other than the current file, the file
  4017. containing the Block becomes the new current file.
  4018.  
  4019.  
  4020. GotoBlockEnd        <Ctrl QK>
  4021. ----------------------------------------
  4022.  
  4023. Positions the cursor at the end of the currently marked Block. If
  4024. the Block is in a file other than the current file, the file
  4025. containing the Block becomes the new current file.
  4026.  
  4027.  3-9
  4028.  
  4029. GotoLine            <Ctrl J>
  4030. ----------------------------------------
  4031.  
  4032. Positions the cursor at the requested line.  The editor will prompt
  4033. for the desired line number.
  4034.  
  4035.  
  4036. GPQuit              <F3> or <Alt Q><Q> or <Esc><Q><Q>
  4037. ----------------------------------------
  4038.  
  4039. Issues the PQuit command for all files that have been loaded.
  4040.  
  4041.  
  4042. GrowWindow          <Ctrl OG> or <Esc><W><R>
  4043. ----------------------------------------
  4044.  
  4045. Changes the size of the current window, if there are multiple 
  4046. windows on the screen.
  4047.  
  4048.  
  4049. GSave               <Alt Y>
  4050. ----------------------------------------
  4051.  
  4052. Issues the SaveFile command for all files that have been modified.
  4053.  
  4054.  
  4055. HalfPgDn
  4056. ----------------------------------------
  4057.  
  4058. Scrolls the text toward the end of the file one-half page.
  4059.  
  4060.  
  4061. HalfPgUp
  4062. ----------------------------------------
  4063.  
  4064. Scrolls the text toward the beginning of the file one-half page.
  4065.  
  4066.  
  4067. HorizontalWindow    <Ctrl OH> or <Esc><W><S>
  4068. ----------------------------------------
  4069.  
  4070. Splits the screen or current window horizontally, creating a new
  4071. window.  Up to eight windows may be displayed on the screen at one
  4072. time.
  4073.  
  4074.  
  4075. InsertDate
  4076. ----------------------------------------
  4077.  
  4078. Inserts the system date at the current cursor position.
  4079.  
  4080.  3-10
  4081.  
  4082. InsertLine          <Alt F2> or <Esc><E><I>
  4083. ----------------------------------------
  4084.  
  4085. Inserts a blank line above the cursor line and positions the cursor
  4086. on the newly created line.  The cursor column does not change.
  4087.  
  4088.  
  4089. InsertTime
  4090. ----------------------------------------
  4091.  
  4092. Inserts the system time at the current cursor position.
  4093.  
  4094.  
  4095. JoinLine            <Alt J> or <Esc><E><J>
  4096. ----------------------------------------
  4097.  
  4098. Joins the line below the cursor line to the end of the cursor line.
  4099. If the cursor is past the end of the line, then the line is joined
  4100. at the cursor position.
  4101.  
  4102.  
  4103. KillFile            <Ctrl KZ>
  4104. ----------------------------------------
  4105.  
  4106. Erases the currently edited file from disk.  The file remains loaded
  4107. in the editor and is marked as being a changed file.  (An asterisk
  4108. will appear on the Status Line preceding the filename.)  This
  4109. command is very useful when available disk space is low.
  4110.  
  4111.  
  4112. LineDown
  4113. ----------------------------------------
  4114.  
  4115. Scrolls the text one line at a time toward the end of the file.  The
  4116. cursor remains stationary on the screen.
  4117.  
  4118.  
  4119. LineUp
  4120. ----------------------------------------
  4121.  
  4122. Scrolls the text one line at a time toward the beginning of the
  4123. file.  The cursor remains stationary on the screen.
  4124.  
  4125.  3-11
  4126.  
  4127. Literal             <Ctrl P>
  4128. ----------------------------------------
  4129.  
  4130. Causes the editor to literally interpret the keystroke that is
  4131. entered immediately following this command.  It is used to insert
  4132. control characters into the currently edited file.  For example, to
  4133. insert the ASCII form-feed character (ASCII 12), you would first
  4134. press <Ctrl P> then <Ctrl L>.  To insert a "null" character into the
  4135. file, press <Ctrl P> and then <Ctrl 2>.  (Note: The "2" must be the
  4136. "2" key on the alphanumeric keyboard, NOT the key on the numeric
  4137. keypad.)  Refer to the "Adding Text" section of Chapter 1 for more
  4138. information.
  4139.  
  4140.  
  4141. MacroRead           <Esc> <M><R>
  4142. ----------------------------------------
  4143.  
  4144. Loads the named macro file, with all macros contained therein, from
  4145. disk into the editor's internal macro buffer.  The macros are
  4146. assigned to the keys exactly as they were originally recorded and
  4147. saved.  The editor prompts the User for the name of the file.
  4148.  
  4149.  
  4150. MacroRecord         <Ctrl M> or <Esc><M><M>
  4151. ----------------------------------------
  4152.  
  4153. Toggles (ON and OFF) macro recording.  If macro recording is OFF, 
  4154. this will turn macro recording ON and prompt for a key to which to 
  4155. assign the macro.  After pressing the desired key (see Appendix B 
  4156. for a list of available keys), all following keystrokes are recorded 
  4157. until the MacroRecord key is pressed again.  After the macro has 
  4158. been recorded, it can be played back by pressing the key to which 
  4159. the macro was assigned.
  4160.  
  4161. Instead of assigning a macro to a specific key, it can be assigned
  4162. to a "scrap" or temporary area by simple pressing <Enter> at the
  4163. prompt.  A macro assigned to the scrap area may be played back by
  4164. entering the ExecuteScrap <Ctrl Enter> command.  The scrap area
  4165. will be updated each time the MacroRecord command is executed.
  4166.  
  4167.  
  4168.  
  4169. MacroWrite          <Esc> <M><W>
  4170. ----------------------------------------
  4171.  
  4172. Saves all currently defined macros to a binary disk file.  The
  4173. editor prompts for the name of the file.
  4174.  
  4175.  3-12
  4176.  
  4177. MainMenu            <Esc>
  4178. ----------------------------------------
  4179.  
  4180. Activates the "Pop-Down" style menu system.  Many of the editor's
  4181. commands can be executed via the menus.
  4182.  
  4183.  
  4184. MakeBotofScreen
  4185. ----------------------------------------
  4186.  
  4187. Scrolls the text in the window so that the cursor line becomes the
  4188. bottom line of the window.
  4189.  
  4190.  
  4191. MakeCtrofScreen     <Shift F5>
  4192. ----------------------------------------
  4193.  
  4194. Scrolls the text in the window so that the cursor line becomes the
  4195. center line of the window.
  4196.  
  4197.  
  4198. MakeTopofScreen     <F5>
  4199. ----------------------------------------
  4200.  
  4201. Scrolls the text in the window so that the cursor line becomes the
  4202. top line of the window.
  4203.  
  4204.  
  4205. MarkBlockBegin      <Ctrl KB> or <Esc><B><B>
  4206. ----------------------------------------
  4207.  
  4208. Marks the beginning of a character Block.  The Block is not shown
  4209. until the MarkBlockEnd command is executed at some position beyond
  4210. the beginning position of the Block.  For an alternate method of
  4211. marking character Blocks, refer to the DropAnchor and MarkCharacter
  4212. commands.
  4213.  
  4214.  
  4215. MarkBlockEnd        <Ctrl KK> or <Esc><B><E>
  4216. ----------------------------------------
  4217.  
  4218. Marks the end of a character Block.  The Block is not shown until
  4219. the MarkBlockBegin command is also executed at some position before
  4220. the end of the Block.  For an alternate method of marking character
  4221. Blocks, refer to the DropAnchor and MarkCharacter commands.
  4222.  
  4223.  3-13
  4224.  
  4225. MarkCharacter
  4226. ----------------------------------------
  4227. This command is used to mark a character Block.  It is similar to
  4228. the DropAnchor command except the cursor position is NOT included as
  4229. part of the Block.
  4230.  
  4231. This command is provided as a replacement for the DropAnchor 
  4232. command. If you want the cursor position included in character 
  4233. Blocks, then continue to use DropAnchor; otherwise, replace the 
  4234. DropAnchor command with this command.
  4235.  
  4236.  
  4237. MarkColumn          <Alt K>
  4238. ----------------------------------------
  4239. This command is used to mark a column Block.  Initially executing
  4240. this command will mark the current cursor position.  As the cursor
  4241. is moved, the Block will "grow".  Executing this command again will
  4242. mark the other end of the Block at the current cursor position.  If
  4243. MarkColumn is executed in a file that already contains a Block, the
  4244. Block is extended to the current cursor position.
  4245.  
  4246.  
  4247. MarkLine            <Alt L> or <Esc><B><L>
  4248. ----------------------------------------
  4249.  
  4250. This command is used to mark a line Block.  Initially executing this
  4251. command will mark the current cursor line.  As the cursor is moved,
  4252. the Block will "grow" with it line by line.  Executing this command
  4253. again will mark the other end of the Block at the current cursor
  4254. line.  If MarkLine is executed in a file that already contains a
  4255. Block, the Block is extended to the current cursor line.
  4256.  
  4257.  
  4258. Match               <Alt F3>
  4259. ----------------------------------------
  4260.  
  4261. Will find the corresponding "(", ")", "{", "}", "[", "]" character.
  4262. This command is primarily intended for programming languages in
  4263. which complicated expressions are grouped with one or more of these
  4264. characters.  This command is very useful for finding unmatched
  4265. parentheses.
  4266.  
  4267.  
  4268. MoveBlock           <Alt M> or <Esc><B><M>
  4269. ----------------------------------------
  4270.  
  4271. Moves (copies and deletes) the currently marked Block to the cursor
  4272. position.  If the Block is a character Block (created using the
  4273. DropAnchor, MarkCharacter, or MarkBlockBegin/End commands) or a
  4274. column Block (created using the MarkColumn command), the Block is
  4275. inserted into the text beginning at the current cursor position.  If
  4276. the Block is a line Block (created using the MarkLine command), it
  4277.  
  4278.  3-14
  4279.  
  4280. is inserted before or after the current cursor line, depending on
  4281. the configuration setting  (Refer to the "General Options" section
  4282. of Chapter 2 for more information).  The Block remains marked.
  4283. Blocks may be moved from one file to another.
  4284.  
  4285. NextFile            <Alt N> or <Alt F><N> or <Esc><F><N>
  4286. ----------------------------------------
  4287.  
  4288. Makes the next file in the ring the new current file when multiple
  4289. files are loaded.
  4290.  
  4291.  
  4292. NextWindow          <Ctrl ON> or <Esc><W><N>
  4293. ----------------------------------------
  4294.  
  4295. Makes the window below the current window the new current window.  
  4296. If the current window is at the bottom of the screen, the top window 
  4297. on the screen will become the current window.
  4298.  
  4299.  
  4300. OneWindow           <Ctrl OO> or <Esc><W><O>
  4301. ----------------------------------------
  4302.  
  4303. Closes all windows except the current window and expands it to
  4304. occupy the entire screen.
  4305.  
  4306.  
  4307. PageDown            <PgDn>
  4308. ----------------------------------------
  4309.  
  4310. Scrolls the text toward the end of the file, one page-full less one
  4311. line, at a time.
  4312.  
  4313.  
  4314. PageUp              <PgUp>
  4315. ----------------------------------------
  4316.  
  4317. Scrolls the text toward the top of the file, one page-full less one
  4318. line, at a time.
  4319.  
  4320.  
  4321.  
  4322. Paste               <grey *>
  4323. ----------------------------------------
  4324.  
  4325. Inserts the contents of the Scrap Buffer at the cursor position.
  4326. The Scrap Buffer is loaded using the Cut or Copy commands.  If the
  4327. Scrap Buffer contains a character or column Block, it is inserted at
  4328. the cursor position. If the Scrap Buffer contains a line Block, it
  4329. is inserted before or after the cursor line depending on the
  4330. configuration setting.  Refer to the "General Options" section of
  4331. Chapter 2 for more information.
  4332.  
  4333. Paste is also available within prompt boxes.
  4334.  
  4335.  3-15
  4336.  
  4337. PasteOver           <Ctrl PrtSc>
  4338. ----------------------------------------
  4339. This is a Paste command for column Blocks.  It takes a column Block
  4340. which has been loaded into the Scrap Buffer using the Cut or Copy
  4341. commands and places it at the current cursor position by overlaying
  4342. existing text and without shifting text to the right.
  4343.  
  4344.  
  4345. PQuit               <Ctrl KQ> or <Alt F><Q> or <Esc><F><Q>
  4346. ----------------------------------------
  4347.  
  4348. This command initiates a protected quit.  If the current file has
  4349. not been modified, it is discarded.  If the current file has been
  4350. modified, the User is warned that changes will be lost.  If multiple
  4351. files are being edited, this command will make the previous file in
  4352. the ring the new current file.
  4353.  
  4354. QEdit can be configured, when only a single file is being edited and
  4355. the PQuit command is issued, to either terminate or prompt for
  4356. another file to edit.  Refer to the "General Options" section of
  4357. Chapter 2 for more information.
  4358.  
  4359.  
  4360. PrevFile            <Ctrl KP> or <Alt F><P> or <Esc><F><P>
  4361. ----------------------------------------
  4362.  
  4363. Makes the previous file in the ring the new current file when
  4364. multiple files are loaded.
  4365.  
  4366.  
  4367. PrevPosition        <Ctrl QP>
  4368. ----------------------------------------
  4369.  
  4370. Positions the cursor at the previous cursor position.  Very helpful
  4371. when used with the GotoLine command.  The GotoLine line can be used
  4372. to go directly to a certain area of the file.  The PrevPosition can
  4373. then be used to return you to the original cursor position.
  4374.  
  4375.  
  4376. PrevWindow          <Ctrl OP> or <Esc><W><P>
  4377. ----------------------------------------
  4378.  
  4379. Makes the window above the current window the new current window. If
  4380. the current window is at the top of the screen, the bottom window on
  4381. the screen will become the current window.
  4382.  
  4383.  
  4384. PrintAll            <Alt P><A> or <Esc><P><A>
  4385. ----------------------------------------
  4386.  
  4387. Prints the entire contents of the current file.
  4388.  
  4389.  3-16
  4390.  
  4391. PrintBlock          <Alt P><B> or <Esc><P><B>
  4392. ----------------------------------------
  4393.  
  4394. Prints the entire contents of the marked Block.  The marked Block
  4395. must be in the current file.
  4396.  
  4397.  
  4398. PrintEject          <Alt P><F> or <Esc><P><F>
  4399. ----------------------------------------
  4400.  
  4401. Sends a formfeed character (ASCII 12) to the printer.
  4402.  
  4403. QuickHelp           <F1> or <Alt H>
  4404. ----------------------------------------
  4405.  
  4406. Displays the Help Screen.  A Help Screen is provided with QEdit;
  4407. however, you may wish to design your own Help Screen.  For more
  4408. information, refer to the "The Help Screen" section of Chapter 2.
  4409.  
  4410.  
  4411. Quit
  4412. ----------------------------------------
  4413.  
  4414. Unconditional quit.  The current file is discarded regardless of any
  4415. changes made to it.  This command is for those who do not like
  4416. software that "nags" you.  USE WITH CAUTION!
  4417.  
  4418.  
  4419. ReadBlock           <Alt R> or <Alt F><R> or <Esc><F><R>
  4420. ----------------------------------------
  4421.  
  4422. Inserts the named disk file at the current cursor position.
  4423.  
  4424. RepeatFind          <Ctrl L> or <Esc><S><A>
  4425. ----------------------------------------
  4426.  
  4427. Repeats the previous Find or FindReplace command.
  4428.  
  4429. ResizeWindow        <Ctrl OG> or <Ctrl OS> or <Esc><W><R>
  4430. ----------------------------------------
  4431.  
  4432. Changes the size of the current window, if there are multiple 
  4433. windows on the screen.
  4434.  
  4435.  
  4436. Return              <Enter>
  4437. ----------------------------------------
  4438.  
  4439. The Return command behaves differently depending on Insert mode and
  4440. AutoIndent mode.
  4441.  
  4442. If Insert mode is OFF, the cursor is positioned at the first column
  4443. of the next line.
  4444.                                           (Continued on next page.)
  4445.  3-17
  4446.  
  4447. If Insert mode is ON, the current cursor line is split at the cursor
  4448. position and any text to the right of and including the cursor
  4449. position is placed on a new line following the current line.  If the
  4450. cursor is past the last character on the line, then a blank line is
  4451. added following the current line.  The cursor is then moved to the
  4452. first column of the new line.
  4453.  
  4454. If AutoIndent is ON, spaces are inserted ahead of the cursor
  4455. position to align it with the text on the previous line.
  4456.  
  4457. If AutoIndent is OFF, the text is moved to the beginning of the
  4458. next line.
  4459.  
  4460. The Return command can be configured to split or not to split lines
  4461. when Insert mode is ON.  Refer to the "Advanced Options" section of
  4462. Chapter 2 for more information.
  4463.  
  4464.  
  4465. SaveFile            <Ctrl KS> or <Alt F><S> or <Esc><F><S>
  4466. ----------------------------------------
  4467.  
  4468. Saves to disk the file currently being edited.  The file remains
  4469. loaded, ready for further editing.
  4470.  
  4471.  
  4472. ScreenLeft          <Alt F5>
  4473. ----------------------------------------
  4474.  
  4475. Shifts the screen to the left, the number of columns specified in
  4476. the configuration program.  Refer to the "Colors/Screen Options"
  4477. section of Chapter 2 for more information.
  4478.  
  4479.  
  4480. ScreenRight         <Alt F6>
  4481. ----------------------------------------
  4482.  
  4483. Shifts the screen to the Right, the number of columns specified in
  4484. the configuration program.  Refer to the "Colors/Screen Options"
  4485. section of Chapter 2 for more information.
  4486.  
  4487.  
  4488. ScrollDown          <Ctrl Z>
  4489. ----------------------------------------
  4490.  
  4491. Scrolls the text one line at a time toward the end of the file.  The
  4492. cursor remains on the same line of text until it reaches the top of
  4493. the screen.
  4494.  
  4495.  3-18
  4496.  
  4497. ScrollUp            <Ctrl W>
  4498. ----------------------------------------
  4499.  
  4500. Scrolls the text one line at a time toward the beginning of the
  4501. file.  The cursor remains on the same line of text until it reaches
  4502. the bottom of the screen.
  4503.  
  4504.  
  4505. SetCtabwidth        <Esc><O><C>
  4506. ----------------------------------------
  4507.  
  4508. Sets the cursor tab width.  This is the width that is used when the
  4509. TabRt or TabLt commands are executed.
  4510.  
  4511.  
  4512. SetEGA25
  4513. ----------------------------------------
  4514. Switches a monitor with an EGA or VGA card to 25-line mode.  This
  4515. command has no effect if the video card is not an EGA or VGA type.
  4516.  
  4517.  
  4518. SetEGA43
  4519. ----------------------------------------
  4520. Switches a monitor with an EGA or VGA card to 43-line mode or
  4521. 50-line mode, respectively.  This command has no effect if the video
  4522. card is not an EGA or VGA type.
  4523.  
  4524.  
  4525. SetPrintLeftMargin  <Alt P><L> or <Esc><P><L>
  4526. ----------------------------------------
  4527.  
  4528. Sets the number of spaces to be printed as a left margin at the
  4529. beginning of each line. The default is zero.
  4530.  
  4531.  
  4532. SetPrintPageSize    <Alt P><P> or <Esc><P><P>
  4533. ----------------------------------------
  4534.  
  4535. Sets the number of lines to be printed per page before sending a
  4536. formfeed.  A value of zero will allow continuous printing (no
  4537. formfeeds sent).
  4538.  
  4539.  
  4540. SetPtabwidth        <Esc><O><P>
  4541. ----------------------------------------
  4542.  
  4543. Sets the Physical Tab Width.  This determines the width to which
  4544. physical tab characters found in files are expanded if Physical Tab
  4545. Expansion is set ON.  It also determines the number of spaces to be
  4546. used for Tabs Out mode.  Refer to the ToggleTabsExpand and
  4547. ToggleTabsOut commands in this chapter for more information.
  4548.  
  4549.  3-19
  4550.  
  4551. SetRmargin          <Ctrl OR> or <Esc><O><R>
  4552. ----------------------------------------
  4553.  
  4554. Sets the right margin for word-wrap and paragraph reformatting.
  4555. WordWrap mode is automatically switched ON whenever the right margin
  4556. is set using this command.
  4557.  
  4558.  
  4559. Shell               <F9> or <Alt F><O> or <Esc><F><O>
  4560. ----------------------------------------
  4561.  
  4562. Invokes a DOS shell.  While in the shell, you can execute DOS and
  4563. other commands.  When you are ready to leave the shell, type
  4564. "exit <Enter>".  You will be back in QEdit, exactly where you
  4565. left off.
  4566.  
  4567. +------------------------------------------------------------+
  4568. | QEdit Tip:                                                 |
  4569. |   You should NOT execute any TSR (terminate and stay       |
  4570. |   resident) programs here. These include the DOS print and |
  4571. |   graph commands and memory-resident programs such as      |
  4572. |   Sidekick and Superkey.                                   |
  4573. +------------------------------------------------------------+
  4574.  
  4575.  
  4576. ShiftLeft           <Shift F7>
  4577. ----------------------------------------
  4578.  
  4579. Shifts the contents of the currently marked Block (or the cursor
  4580. line, if the cursor does not reside in a marked Block) one position
  4581. to the left.  If you issue this command when the leftmost
  4582. character(s) of the line(s) being shifted is in column 1, that
  4583. character(s) will be deleted to allow the remainder of the line to
  4584. shift left one position.
  4585.  
  4586.  
  4587. ShiftRight          <Shift F8>
  4588. ----------------------------------------
  4589.  
  4590. Shifts the contents of the currently marked Block (or the cursor
  4591. line, if the cursor does not reside in a marked Block) one position
  4592. to the right.  If you issue this command when the rightmost
  4593. character(s) of the line(s) being shifted is in column 512, that
  4594. character(s) will be deleted to allow the remainder of the line to
  4595. shift right one position.
  4596.  
  4597.  
  4598. ShowEntryScreen     <Alt F10>
  4599. ----------------------------------------
  4600.  
  4601. Displays the original DOS screen as it appeared upon initial
  4602. execution of the editor.  Pressing any key will return you to the
  4603. edit screen.
  4604.  
  4605.  3-20
  4606.  
  4607. ShrinkWindow        <Ctrl OS> or <Esc><W><R>
  4608. ----------------------------------------
  4609.  
  4610. Changes the size of the current window, if there are multiple
  4611. windows on the screen.
  4612.  
  4613.  
  4614.  
  4615. SplitLine           <Alt S> or <Esc><E><S>
  4616. ----------------------------------------
  4617.  
  4618. Splits the current cursor line at the cursor position.  Any text to
  4619. the right of and including the cursor position is placed on a new
  4620. line following the current line.  If the cursor is past the last
  4621. character on the line, then a blank line is added following the
  4622. current line. The cursor position does not change.
  4623.  
  4624.  
  4625. StoreScrbuff        <Ctrl BS>
  4626. ----------------------------------------
  4627.  
  4628. Copies the currently marked Block to the named Scratch Buffer. The
  4629. editor will prompt for the name of the Scratch Buffer.  The contents
  4630. of all Scratch Buffers are lost when the editor is terminated.
  4631.  
  4632.  
  4633. TabLt               <Shift Tab>
  4634. ----------------------------------------
  4635.  
  4636. Positions the cursor at the previous tab position, as defined by the 
  4637. tab width. If in Insert mode, the text to the right of, and including 
  4638. the cursor position, also shifts left.  If in Insert mode AND inside 
  4639. a marked block, the entire block shifts left by the current cursor 
  4640. tab width (if appropriate advanced configuration option is set).
  4641.  
  4642.  
  4643. TabRt               <Tab>
  4644. ----------------------------------------
  4645.  
  4646. Positions the cursor at the next tab position, as defined by the 
  4647. cursor tab width.  If in Insert mode, the text to the right of, and 
  4648. including the cursor position, also shifts right.  If in Insert mode 
  4649. AND inside a marked block, the entire block shifts right by the 
  4650. current cursor tab width (if appropriate advanced configuration 
  4651. option is set).
  4652.  
  4653.  
  4654. ToggleBakups        <Esc><O><B>
  4655. ----------------------------------------
  4656.  
  4657. Toggles file backups ON and OFF.  If ON, QEdit will create a backup
  4658. file using the ".bak" file extension whenever a modified file is
  4659. saved.
  4660.  
  4661.  3-21
  4662.  
  4663. ToggleBoxDraw       <Shift F1>
  4664. ----------------------------------------
  4665.  
  4666. Toggles Box Drawing mode ON and OFF.  If ON, the cursor movement
  4667. keys (up, down, right, left) will "draw" lines in the text, both
  4668. up/down and right/left.  Very useful for creating charts and tables.
  4669.  
  4670. The letter "B" will appear on the Status Line when this mode is ON.
  4671.  
  4672.  
  4673. ToggleEGA43         <Ctrl F1>
  4674. ----------------------------------------
  4675. Toggles an EGA monitor between 25-line and 43-line mode or a VGA
  4676. monitor between 25-line and 50-line mode.  This command has no
  4677. effect if the video card is not an EGA or VGA type.
  4678.  
  4679.  
  4680. ToggleEnterMatching <Esc><O><E>
  4681. ----------------------------------------
  4682.  
  4683. Toggles EnterMatching mode ON and OFF.  If ON, the double quote,
  4684. parenthesis, and square bracket keys all automatically enter the
  4685. matching character when the left character is entered.  For example,
  4686. typing the '[' key automatically enters a ']' immediately following.
  4687.  
  4688.  
  4689. ToggleIndent        <Ctrl QI> or <Esc><O><A>
  4690. ----------------------------------------
  4691.  
  4692. Toggles AutoIndent mode ON and OFF.  If ON, the cursor is positioned
  4693. at the current left margin whenever the <Enter> key is pressed.
  4694. The current left margin is determined by the first non-blank
  4695. character on the immediately preceding line.
  4696.  
  4697. Paragraph reformatting and word-wrapping will also use the current
  4698. left margin when AutoIndent mode is ON.
  4699.  
  4700. The letter "A" will appear on the Status Line when this mode is ON.
  4701.  
  4702.  
  4703. ToggleInsert        <Ins> or <Esc><O><I>
  4704. ----------------------------------------
  4705.  
  4706. Toggles Insert mode ON and OFF.  If ON, text to the right of the
  4707. cursor on the cursor line is shifted whenever characters, spaces,
  4708. the Backspace command, the TabLt command, or the TabRt command is
  4709. entered.  Also, entering the Return command will cause a line split
  4710. at the current cursor position.
  4711.  
  4712. The letter "I" will appear on the Status Line when this mode is ON.
  4713.  
  4714.  3-22
  4715.  
  4716. ToggleSmartTabs     <Ctrl QT>
  4717. ----------------------------------------
  4718.  
  4719. Toggles Smart Tabs ON and OFF.  If ON, the TabRt and TabLt commands
  4720. will place the cursor beneath the beginning of the next (or previous)
  4721. word on the first nonblank line preceding the current cursor line.
  4722.  
  4723. Smart Tabs mode should NOT be set ON while C mode is ON.
  4724.  
  4725.  
  4726. ToggleTabsExpand    <Alt V>
  4727. ----------------------------------------
  4728.  
  4729. Toggles Physical Tab Expansion ON and OFF.  If ON, physical tab
  4730. characters (ASCII 9's) found in a file will be expanded into spaces
  4731. according to the Physical Tab Width set in the configuration
  4732. program.  If OFF, physical tabs will be displayed on the screen and
  4733. a physical tab character will be placed in the text each time the
  4734. TabRt command is entered.
  4735.  
  4736.  
  4737. ToggleTabsOut       <Alt I>
  4738. ----------------------------------------
  4739.  
  4740. Toggles Tabs Out mode ON and OFF.  If ON, continuous spaces in a
  4741. line of text will be replaced with physical tabs (ASCII 9's)
  4742. according to the Physical Tab Width set in the configuration program.
  4743. Only spaces in edited lines are replaced with physical tabs. Spaces
  4744. falling between single or double quotes will not be replaced.
  4745.  
  4746.  
  4747. ToggleWordwrap      <Ctrl OW> or <Esc><O><W>
  4748. ----------------------------------------
  4749.  
  4750. Toggles WordWrap mode ON and OFF.  If ON, the cursor, along with
  4751. the word currently being typed, will automatically advance to the
  4752. next line whenever a character is typed beyond the right margin.
  4753. The right margin can be permanently set using the configuration
  4754. program (refer to the "General Options" section of Chapter 2 for
  4755. more information) or temporarily changed using the SetRmargin
  4756. command.
  4757.  
  4758. The letter "W" will appear on the Status Line when this mode is ON.
  4759.  
  4760.  
  4761. UndoCursorline      <Ctrl QL>
  4762. ----------------------------------------
  4763.  
  4764. Reverses any changes made to the current cursor line (except changes
  4765. made with the FindReplace command).  If the cursor has been moved
  4766. from the changed line or a file or window command is executed, the
  4767. changes cannot be undone.
  4768.  
  4769.  3-23
  4770.  
  4771. UnKill              <Ctrl U> or <Esc><E><U>
  4772. ----------------------------------------
  4773.  
  4774. Recovers the last deleted entry from the current file's Kill Buffer.
  4775. Deleted blocks and lines will be inserted immediately before the
  4776. current cursor line and deleted words will be inserted immediately
  4777. before the current cursor position.
  4778.  
  4779. The number of lines saved in the Kill Buffer may be set with the
  4780. configuration program.  Refer to the "General Options" section of
  4781. Chapter 2 for more information.
  4782.  
  4783.  
  4784. UnmarkBlock         <Alt U> or <Esc><B><U>
  4785. ----------------------------------------
  4786.  
  4787. Unmarks the currently marked Block.
  4788.  
  4789. WordLeft            <Ctrl Cursor Left>
  4790. ----------------------------------------
  4791.  
  4792. Positions the cursor at the first character of the previous word.
  4793.  
  4794.  
  4795. WordRight           <Ctrl Cursor Right>
  4796. ----------------------------------------
  4797.  
  4798. Positions the cursor at the first character of the following word.
  4799.  
  4800. WrapPara            <Alt B>
  4801. ----------------------------------------
  4802.  
  4803. Reformats text from the current cursor position until a blank line
  4804. or end of file is encountered.  If AutoIndent is ON, the line below
  4805. the cursor line is used for the left margin.  Otherwise, a left
  4806. margin of zero is used.  The right margin is determined by the
  4807. configuration program or the SetRmargin command.
  4808.  
  4809.  
  4810. WriteBlock          <Alt W> or <Alt F><W> or <Esc><F><W>
  4811. ----------------------------------------
  4812.  
  4813. Writes the currently marked Block to the named file.  The editor
  4814. will prompt for the name of the file.
  4815.  
  4816.  
  4817. ZoomWindow          <Ctrl OZ> or <Esc><W><Z>
  4818. ----------------------------------------
  4819.  
  4820. Toggles Zoom mode ON and OFF.  If there are multiple windows on the
  4821. screen, entering the ZoomWindow command will cause the current
  4822. window to fill the entire screen.  Pressing ZoomWindow again
  4823. restores the other windows to the screen.
  4824.  
  4825.  3-24
  4826.  
  4827. APPENDIX A.  LIST OF COMMANDS_______________________________________
  4828.  
  4829.                         +-------------+
  4830.                         | By Function |
  4831.                         +-------------+
  4832.  
  4833.                       Menu (Esc)  Default               Customized
  4834. Command               Sequence    Keystroke             Keystroke
  4835. --------------------  ----------  --------------------  ----------
  4836.  
  4837. Cursor Movement
  4838. ---------------
  4839. BegFile                           Ctrl PgUp
  4840. BegLine                           Home
  4841. BegScreen                         Ctrl Home
  4842. CursorDown                        Cursor Down
  4843. CursorLeft                        Cursor Left
  4844.  
  4845. CursorRight                       Cursor Right
  4846. CursorUp                          Cursor Up
  4847. EndFile                           Ctrl PgDn
  4848. EndLine                           End
  4849. EndScreen                         Ctrl End
  4850.  
  4851. GotoBlockBeg                      Ctrl QB
  4852. GotoBlockEnd                      Ctrl QK
  4853. GotoLine                          Ctrl J
  4854. HalfPgDn
  4855. HalfPgUp
  4856.  
  4857. LineDown
  4858. LineUp
  4859. MakeBotofScreen
  4860. MakeCtrofScreen                   Shift F5
  4861. MakeTopofScreen                   F5
  4862.  
  4863.  A-1
  4864.  
  4865. PageDown                          PgDn
  4866. PageUp                            PgUp
  4867. PrevPosition                      Ctrl QP
  4868. ScreenLeft                        Alt  F5
  4869. ScreenRight                       Alt  F6
  4870.  
  4871. ScrollDown                        Ctrl Z
  4872. ScrollUp                          Ctrl W
  4873. WordLeft                          Ctrl Cursor Left
  4874. WordRight                         Ctrl Cursor Right
  4875.  
  4876.  
  4877. Editing
  4878. -------
  4879. AddLine               EA          F2
  4880. Align
  4881. Backspace                         Backspace
  4882. DelCh                             Del
  4883. DelLine               ED          Alt  D
  4884.  
  4885. DelLtWord                         Ctrl Backspace
  4886. DelRtWord                         Ctrl T
  4887. DelToEol              EE          F6
  4888. DupLine                           F4
  4889. GetPrev                           Ctrl - (dash)
  4890.  
  4891. InsertLine            EI          Alt  F2
  4892. JoinLine              EJ          Alt  J
  4893. Literal                           Ctrl P
  4894. Return                            Enter
  4895. SplitLine             ES          Alt  S
  4896.  
  4897. UnKill                EU          Ctrl U
  4898.  
  4899.  
  4900. Block/Scratch Buffer
  4901. --------------------
  4902. AppendScrbuff                     Ctrl BA
  4903. Copy                              grey +
  4904. CopyBlock             BC          Alt  C
  4905. CopyOverBlock                     Alt  Z
  4906. Cut                               grey -
  4907.  
  4908.  A-2
  4909.  
  4910. DeleteBlock           BD          Alt  G
  4911. DropAnchor                        Alt  A
  4912. GetScrbuff                        Ctrl BL
  4913. MarkBlockBegin        BB          Ctrl KB or F7
  4914. MarkBlockEnd          BE          Ctrl KK or F8
  4915.  
  4916. MarkCharacter
  4917. MarkColumn                        Alt  K
  4918. MarkLine              BL          Alt  L
  4919. MoveBlock             BM          Alt  M
  4920. Paste                             grey *
  4921.  
  4922. PasteOver                         Ctrl PrtSc
  4923. ShiftLeft                         Shift F7
  4924. ShiftRight                        Shift F8
  4925. StoreScrbuff                      Ctrl BS
  4926. UnmarkBlock           BU          Alt  U
  4927.  
  4928.  
  4929. File
  4930. ----
  4931. ChangeFilename        FC          Alt  O  or Alt  F,C
  4932. EditFile              FL          Alt  E  or Alt  F,L
  4933. Exit                              Ctrl KD
  4934. File                  FF          Ctrl KX or Alt  F,F
  4935. GExit                 QX          Alt  X  or Alt  Q,X
  4936.  
  4937. GFile                 FG          Alt  F,G
  4938. GPQuit                QQ          F3      or Alt  Q,Q
  4939. GSave                             Alt  Y
  4940. KillFile                          Ctrl KZ
  4941. NextFile              FN          Alt  N  or Alt  F,N
  4942.  
  4943. PQuit                 FQ          Ctrl KQ or Alt  F,Q
  4944. PrevFile              FP          Ctrl KP or Alt  F,P
  4945. Quit
  4946. ReadBlock             FR          Alt  R  or Alt  F,R
  4947. SaveFile              FS          Ctrl KS or Alt  F,S
  4948.  
  4949. WriteBlock            FW          Alt  W  or Alt  F,W
  4950.  
  4951.  A-3
  4952.  
  4953. Window
  4954. ------
  4955. CloseWindow           WC          Ctrl OC
  4956. GrowWindow            WG          Ctrl OG
  4957. HorizontalWindow      WS          Ctrl OH
  4958. NextWindow            WN          Ctrl ON
  4959. OneWindow             WO          Ctrl OO
  4960.  
  4961. PrevWindow            WP          Ctrl OP
  4962. ShrinkWindow          WR          Ctrl OS
  4963. ZoomWindow            WZ          Ctrl OZ
  4964.  
  4965.  
  4966. Macro
  4967. -----
  4968. CurrentFilename
  4969. ExecuteScrap                      Ctrl Enter
  4970. MacroRead             MR
  4971. MacroRecord           MM          Ctrl M
  4972. MacroWrite            MW
  4973.  
  4974.  
  4975. Printing
  4976. --------
  4977. PrintAll              PA          Alt  P,A
  4978. PrintBlock            PB          Alt  P,B
  4979. PrintEject            PF          Alt  P,F
  4980. SetPrintLeftMargin    PL          Alt  P,L
  4981. SetPrintPageSize      PP          Alt  P,P
  4982.  
  4983.  
  4984. Tab
  4985. ---
  4986. SetCtabwidth          OC
  4987. SetPtabwidth          OP
  4988. TabLt                             Shift Tab
  4989. TabRt                             Tab
  4990.  
  4991.  A-4
  4992.  
  4993. Find/Replace
  4994. ------------
  4995. Find                  SF          Ctrl QF
  4996. FindReplace           SR          Ctrl QA
  4997. RepeatFind            SA          Ctrl L
  4998.  
  4999.  
  5000. Toggles
  5001. -------
  5002. ToggleBakups          OB
  5003. ToggleBoxDraw                     Shift F1
  5004. ToggleEnterMatching   OE
  5005. ToggleIndent          OA          Ctrl QI
  5006. ToggleInsert          OI          Ins
  5007.  
  5008. ToggleSmartTabs                   Ctrl QT
  5009. ToggleTabsExpand                  Alt  V
  5010. ToggleTabsOut                     Alt  I
  5011. ToggleWordwrap        OW          Ctrl OW
  5012.  
  5013.  
  5014. Other
  5015. -----
  5016. Dos                               Alt  F9
  5017. Escape                            Escape
  5018. InsertDate
  5019. InsertTime
  5020. MainMenu                          Escape
  5021.  
  5022. Match                             Alt  F3
  5023. QuickHelp                         Alt  H  or F1
  5024. SetEGA25
  5025. SetEGA43
  5026. SetRmargin            OR          Ctrl OR
  5027.  
  5028. Shell                 FO          F9      or Alt  F,O
  5029. ShowEntryScreen                   Alt  F10
  5030. ToggleEGA43                       Ctrl F1
  5031. UndoCursorline                    Ctrl QL
  5032. WrapPara                          Alt  B
  5033.  
  5034.  A-5
  5035.  
  5036.                         +----------------+
  5037.                         | Alphabetically |
  5038.                         +----------------+
  5039.  
  5040.                       Menu (Esc)  Default               Customized
  5041. Command               Sequence    Keystroke             Keystroke
  5042. --------------------  ----------  --------------------  ----------
  5043.  
  5044. AddLine               EA          F2
  5045. Align
  5046. AppendScrbuff                     Ctrl BA
  5047. Backspace                         Backspace
  5048. BegFile                           Ctrl PgUp
  5049.  
  5050. BegLine                           Home
  5051. BegScreen                         Ctrl Home
  5052. ChangeFilename        FC          Alt  O  or Alt  F,C
  5053. CloseWindow           WC          Ctrl OC
  5054. Copy                              grey +
  5055.  
  5056. CopyBlock             BC          Alt  C
  5057. CopyOverBlock                     Alt  Z
  5058. CurrentFilename
  5059. CursorDown                        Cursor Down
  5060. CursorLeft                        Cursor Left
  5061.  
  5062. CursorRight                       Cursor Right
  5063. CursorUp                          Cursor Up
  5064. Cut                               grey -
  5065. DelCh                             Del
  5066. DeleteBlock           BD          Alt  G
  5067.  
  5068. DelLine               ED          Alt  D
  5069. DelLtWord                         Ctrl Backspace
  5070. DelRtWord                         Ctrl T
  5071. DelToEol              EE          F6
  5072. Dos                               Alt  F9
  5073.  
  5074. DropAnchor                        Alt  A
  5075. DupLine                           F4
  5076. EditFile              FL          Alt  E  or Alt  F,L
  5077. EndFile                           Ctrl PgDn
  5078. EndLine                           End
  5079.  
  5080. EndScreen                         Ctrl End
  5081. Escape                            Escape
  5082. ExecuteScrap                      Ctrl Enter
  5083. Exit                              Ctrl KD
  5084. File                  FF          Ctrl KX or Alt  F,F
  5085.  
  5086.  A-6
  5087.  
  5088. Find                  SF          Ctrl QF
  5089. FindReplace           SR          Ctrl QA
  5090. GetPrev                           Ctrl - (dash)
  5091. GetScrbuff                        Ctrl BL
  5092. GExit                 QX          Alt  X  or Alt  Q,X
  5093.  
  5094. GFile                 FG          Alt  F,G
  5095. GotoBlockBeg                      Ctrl QB
  5096. GotoBlockEnd                      Ctrl QK
  5097. GotoLine                          Ctrl J
  5098. GPQuit                QQ          F3      or Alt  Q,Q
  5099.  
  5100. GrowWindow            WG          Ctrl OG
  5101. GSave                             Alt  Y
  5102. HalfPgDn
  5103. HalfPgUp
  5104. HorizontalWindow      WS          Ctrl OH
  5105.  
  5106. InsertDate
  5107. InsertLine            EI          Alt  F2
  5108. InsertTime
  5109. JoinLine              EJ          Alt  J
  5110. KillFile                          Ctrl KZ
  5111.  
  5112. LineDown
  5113. LineUp
  5114. Literal                           Ctrl P
  5115. MacroRead             MR
  5116. MacroRecord           MM          Ctrl M
  5117.  
  5118. MacroWrite            MW
  5119. MainMenu                          Escape
  5120. MakeBotofScreen
  5121. MakeCtrofScreen                   Shift F5
  5122. MakeTopofScreen                   F5
  5123.  
  5124. MarkBlockBegin        BB          Ctrl KB or F7
  5125. MarkBlockEnd          BE          Ctrl KK or F8
  5126. MarkCharacter
  5127. MarkColumn                        Alt  K
  5128. MarkLine              BL          Alt  L
  5129.  
  5130.  A-7
  5131.  
  5132. Match                             Alt  F3
  5133. MoveBlock             BM          Alt  M
  5134. NextFile              FN          Alt  N  or Alt  F,N
  5135. NextWindow            WN          Ctrl ON
  5136. OneWindow             WO          Ctrl OO
  5137.  
  5138. PageDown                          PgDn
  5139. PageUp                            PgUp
  5140. Paste                             grey *
  5141. PasteOver                         Ctrl PrtSc
  5142. PQuit                 FQ          Ctrl KQ or Alt  F,Q
  5143.  
  5144. PrevFile              FP          Ctrl KP or Alt  F,P
  5145. PrevPosition                      Ctrl QP
  5146. PrevWindow            WP          Ctrl OP
  5147. PrintAll              PA          Alt  P,A
  5148. PrintBlock            PB          Alt  P,B
  5149.  
  5150. PrintEject            PF          Alt  P,F
  5151. QuickHelp                         Alt  H  or F1
  5152. Quit
  5153. ReadBlock             FR          Alt  R  or Alt  F,R
  5154. RepeatFind            SA          Ctrl L
  5155.  
  5156. Return                            Enter
  5157. SaveFile              FS          Ctrl KS or Alt  F,S
  5158. ScreenLeft                        Alt  F5
  5159. ScreenRight                       Alt  F6
  5160. ScrollDown                        Ctrl Z
  5161.  
  5162. ScrollUp                          Ctrl W
  5163. SetCtabwidth          OC
  5164. SetEGA25
  5165. SetEGA43
  5166. SetPrintLeftMargin    PL          Alt  P,L
  5167.  
  5168. SetPrintPageSize      PP          Alt  P,P
  5169. SetPtabwidth          OP
  5170. SetRmargin            OR          Ctrl OR
  5171. Shell                 FO          F9      or Alt  F,O
  5172. ShiftLeft                         Shift F7
  5173.  
  5174.  A-8
  5175.  
  5176. ShiftRight                        Shift F8
  5177. ShowEntryScreen                   Alt  F10
  5178. ShrinkWindow          WR          Ctrl OS
  5179. SplitLine             ES          Alt  S
  5180. StoreScrbuff                      Ctrl BS
  5181.  
  5182. TabLt                             Shift Tab
  5183. TabRt                             Tab
  5184. ToggleBakups          OB
  5185. ToggleBoxDraw                     Shift F1
  5186. ToggleEGA43                       Ctrl F1
  5187.  
  5188. ToggleEnterMatching   OE
  5189. ToggleIndent          OA          Ctrl QI
  5190. ToggleInsert          OI          Ins
  5191. ToggleSmartTabs                   Ctrl QT
  5192. ToggleTabsExpand                  Alt  V
  5193.  
  5194. ToggleTabsOut                     Alt  I
  5195. ToggleWordwrap        OW          Ctrl OW
  5196. UndoCursorline                    Ctrl QL
  5197. UnKill                EU          Ctrl U
  5198. UnmarkBlock           BU          Alt  U
  5199.  
  5200. WordLeft                          Ctrl Cursor Left
  5201. WordRight                         Ctrl Cursor Right
  5202. WrapPara                          Alt  B
  5203. WriteBlock            FW          Alt  W  or Alt  F,W
  5204. ZoomWindow            WZ          Ctrl OZ
  5205.  
  5206.  A-9
  5207.  
  5208. APPENDIX B.  LIST OF CONFIGURABLE KEYS______________________________
  5209.  
  5210.                         +---------------+
  5211.                         | Function Keys |
  5212.                         +---------------+
  5213.  
  5214. Keystroke    Default Command   |  Keystroke    Default Command
  5215. ---------    ---------------   |  ---------    ---------------
  5216. F1           QuickHelp         |  Shift F1     ToggleBoxDraw
  5217. F2           AddLine           |  Shift F2
  5218. F3           GPQuit            |  Shift F3
  5219. F4           DupLine           |  Shift F4
  5220. F5           MakeTopofScreen   |  Shift F5     MakeCtrofScreen
  5221.                                |
  5222. F6           DelToEol          |  Shift F6
  5223. F7           MarkBlockBegin    |  Shift F7     ShiftLeft
  5224. F8           MarkBlockEnd      |  Shift F8     ShiftRight
  5225. F9           Shell             |  Shift F9
  5226. F10                            |  Shift F10
  5227. -------------------------------+------------------------------
  5228. Ctrl F1      ToggleEGA43       |  Alt F1
  5229. Ctrl F2                        |  Alt F2       InsertLine
  5230. Ctrl F3                        |  Alt F3       Match
  5231. Ctrl F4                        |  Alt F4
  5232. Ctrl F5                        |  Alt F5       ScreenLeft
  5233.                                |
  5234. Ctrl F6                        |  Alt F6       ScreenRight
  5235. Ctrl F7                        |  Alt F7
  5236. Ctrl F8                        |  Alt F8
  5237. Ctrl F9                        |  Alt F9       Dos
  5238. Ctrl F10                       |  Alt F10      ShowEntryScreen
  5239.  
  5240.  B-1
  5241.  
  5242.                        +----------------------+
  5243.                        | Special Purpose Keys |
  5244.                        +----------------------+
  5245.  
  5246. Keystroke      Default Command | Keystroke         Default Command
  5247. ------------   --------------- | ----------------  ----------------
  5248. Backspace      Backspace       | Ctrl Backspace    DelLtWord
  5249. Cursor down    CursorDown      |
  5250. Cursor left    CursorLeft      | Ctrl Cursor left  WordLeft
  5251. Cursor right   CursorRight     | Ctrl Cursor right WordRight
  5252. Cursor up      CursorUp        |
  5253.                                |
  5254. Del            DelCh           | Shift Del
  5255. End            EndLine         | Ctrl End          EndScreen
  5256. Enter          Return          | Ctrl Enter        ExecuteScrap
  5257. Escape         Escape          |
  5258. grey *         Paste           |
  5259.                                |
  5260. grey +         Copy            |
  5261. grey -         Cut             |
  5262. Home           BegLine         | Ctrl Home         BegScreen
  5263. Ins            ToggleInsert    | Shift Ins
  5264. PgDn           PageDown        | Ctrl PgDn         EndFile
  5265.                                |
  5266. PgUp           PageUp          | Ctrl PgUp         BegFile
  5267. Tab            TabRt           | Shift Tab         TabLt
  5268. `                              |
  5269. /                              |
  5270. ~ (tilde)                      |
  5271.                                |
  5272.                                | Ctrl PrtSc        PasteOver
  5273.                                | Ctrl [
  5274.                                | Ctrl ]
  5275.                                | Ctrl -            GetPrev
  5276.                                | Ctrl \
  5277.                                | Ctrl 2
  5278.                                | Ctrl 6
  5279.  
  5280.  B-2
  5281.  
  5282.                         +--------------+
  5283.                         | Control Keys |
  5284.                         +--------------+
  5285.  
  5286.  
  5287.  Keystroke   Default Command    |  Keystroke   Default Command
  5288.  ---------   ---------------    |  ---------   ---------------
  5289.  Ctrl A      WordLeft           |  Ctrl P      Literal
  5290. *Ctrl BA     AppendScrbuff      | *Ctrl QA     FindReplace
  5291.  Ctrl BL     GetScrbuff         |  Ctrl QB     GotoBlockBeg
  5292.  Ctrl BS     StoreScrbuff       |  Ctrl QC     EndFile
  5293.  Ctrl C      PageDown           |  Ctrl QD     EndLine
  5294.                                 |
  5295.  Ctrl D      CursorRight        |  Ctrl QE     BegScreen
  5296.  Ctrl E      CursorUp           |  Ctrl QF     Find
  5297.  Ctrl F      WordRight          |  Ctrl QI     ToggleIndent
  5298.  Ctrl G      DelCh              |  Ctrl QK     GotoBlockEnd
  5299.  Ctrl H      Backspace          |  Ctrl QL     UndoCursorline
  5300.                                 |
  5301.  Ctrl I      TabRt              |  Ctrl QP     PrevPosition
  5302.  Ctrl J      GotoLine           |  Ctrl QR     BegFile
  5303. *Ctrl KB     MarkBlockBegin     |  Ctrl QS     BegLine
  5304.  Ctrl KC     CopyBlock          |  Ctrl QT     ToggleSmartTabs
  5305.  Ctrl KD     Exit               |  Ctrl QX     EndScreen
  5306.                                 |
  5307.  Ctrl KE     EditFile           |  Ctrl QY     DelToEol
  5308.  Ctrl KF     ChangeFilename     |  Ctrl R      PageUp
  5309.  Ctrl KH     UnmarkBlock        |  Ctrl S      CursorLeft
  5310.  Ctrl KK     MarkBlockEnd       |  Ctrl T      DelRtWord
  5311.  Ctrl KN     NextFile           |  Ctrl U      UnKill
  5312.                                 |
  5313.  Ctrl KP     PrevFile           |  Ctrl V      ToggleInsert
  5314.  Ctrl KQ     PQuit              |  Ctrl W      ScrollUp
  5315.  Ctrl KR     ReadBlock          |  Ctrl X      CursorDown
  5316.  Ctrl KS     SaveFile           |  Ctrl Y      DelLine
  5317.  Ctrl KT     ToggleTabsExpand   |  Ctrl Z      ScrollDown
  5318.                                 |
  5319.  Ctrl KV     MoveBlock          |
  5320.  Ctrl KW     WriteBlock         |
  5321.  Ctrl KX     File               |
  5322.  Ctrl KY     DeleteBlock        |
  5323.  Ctrl KZ     KillFile           |
  5324.                                 |
  5325.  Ctrl L      RepeatFind         |
  5326.  Ctrl M      MacroRecord        |
  5327.  Ctrl N      SplitLine          |
  5328. *Ctrl OC     CloseWindow        |
  5329.  Ctrl OG     GrowWindow         |
  5330.  
  5331.  B-3
  5332.  
  5333.  Ctrl OH     HorizontalWindow   |
  5334.  Ctrl OL     SetPrintLeftMargin |
  5335.  Ctrl ON     NextWindow         |
  5336.  Ctrl OO     OneWindow          |
  5337.  Ctrl OP     PrevWindow         |
  5338.                                 |
  5339.  Ctrl OR     SetRmargin         |
  5340.  Ctrl OS     ShrinkWindow       |
  5341.  Ctrl OW     ToggleWordwrap     |
  5342.  Ctrl OZ     ZoomWindow         |
  5343.  
  5344. * QEdit allows you to assign commands to "twokey" combinations. A
  5345.   twokey consists of two distinct keystrokes, such as <Ctrl B>
  5346.   immediately followed by <A>. Please note that keystrokes such as
  5347.   <Ctrl A> and <Alt C> by themselves each count as only one
  5348.   keystroke, just as <shift F1> is only one keystroke.  You cannot
  5349.   assign a QEdit command to a key which is already being used as the
  5350.   first keystroke of a twokey.
  5351.  
  5352.  B-4
  5353.  
  5354.                         +----------------+
  5355.                         | Alternate Keys |
  5356.                         +----------------+
  5357.  
  5358.  
  5359. Keystroke   Default Command         |  Keystroke   Default Command
  5360. ---------   ---------------         |  ---------   ---------------
  5361. Alt A       DropAnchor              |  Alt 1
  5362. Alt B       WrapPara                |  Alt 2
  5363. Alt C       CopyBlock               |  Alt 3
  5364. Alt D       DelLine                 |  Alt 4
  5365. Alt E       EditFile                |  Alt 5
  5366.                                     |
  5367. Alt F       MacroBegin MainMenu 'f' |  Alt 6
  5368. Alt G       DeleteBlock             |  Alt 7
  5369. Alt H       QuickHelp               |  Alt 8
  5370. Alt I       ToggleTabsOut           |  Alt 9
  5371. Alt J       JoinLine                |  Alt 0
  5372.                                     |
  5373. Alt K       MarkColumn              |  Alt -
  5374. Alt L       MarkLine                |  Alt =
  5375. Alt M       MoveBlock               |
  5376. Alt N       NextFile                |
  5377. Alt O       ChangeFilename          |
  5378.                                     |
  5379. Alt P       MacroBegin MainMenu 'p' |
  5380. Alt Q       MacroBegin MainMenu 'q' |
  5381. Alt R       ReadBlock               |
  5382. Alt S       SplitLine               |
  5383. Alt T                               |
  5384.                                     |
  5385. Alt U       UnmarkBlock             |
  5386. Alt V       ToggleTabsExpand        |
  5387. Alt W       WriteBlock              |
  5388. Alt X       GExit                   |
  5389. Alt Y       GSave                   |
  5390.                                     |
  5391. Alt Z       CopyOverBlock           |
  5392.  
  5393.  B-5
  5394.  
  5395.                     +------------------------+
  5396.                     | Enhanced Keyboard Keys |
  5397.                     +------------------------+
  5398.  
  5399. Keystroke    Default Command     |  Keystroke    Default Command
  5400. ---------    ---------------     |  ---------    ---------------
  5401. F11                              |  Alt F11
  5402. F12                              |  Alt F12
  5403. Shift F11                        |  Alt '
  5404. Shift F12                        |  Alt ,
  5405. Ctrl F11                         |  Alt .
  5406.                                  |
  5407. Ctrl F12                         |  Alt /
  5408. Ctrl Center Cursor               |  Alt \
  5409. Ctrl Cursor Down                 |  Alt ;
  5410. Ctrl Cursor Up                   |  Alt [
  5411. Ctrl Del                         |  Alt ]
  5412.                                  |
  5413. Ctrl grey *                      |  Alt `
  5414. Ctrl grey +                      |  Alt Backspace
  5415. Ctrl grey -                      |  Alt Enter
  5416. Ctrl grey /                      |  Alt Escape
  5417. Ctrl Ins                         |  Alt grey *
  5418.                                  |
  5419. Ctrl Tab                         |  Alt grey +
  5420. Center Cursor                    |  Alt grey -
  5421. grey Enter                       |  Alt grey /
  5422. Ctrl grey Enter                  |  Alt grey Cursor Down
  5423.                                  |  Alt grey Cursor Left
  5424.                                  |
  5425.                                  |  Alt grey Cursor Right
  5426.                                  |  Alt grey Cursor Up
  5427.                                  |  Alt grey Del
  5428.                                  |  Alt grey End
  5429.                                  |  Alt grey Home
  5430.                                  |
  5431.                                  |  Alt grey Ins
  5432.                                  |  Alt grey PgDn
  5433.                                  |  Alt grey PgUp
  5434.                                  |  Alt grey Enter
  5435.                                  |  Alt Tab
  5436.  
  5437.  
  5438. A list of all configurable keys is also contained in the QCONFIG.DAT
  5439. file on the QEdit distribution diskette.
  5440.  
  5441.  
  5442.  B-6
  5443.  
  5444. APPENDIX C.  ERROR MESSAGES_________________________________________
  5445.  
  5446. This Appendix contains an alphabetical list of the error messages
  5447. that can be displayed by QEdit.  Each message has a description and,
  5448. as required, a resolution.  There is a separate list for QCONFIG
  5449. (the configuration program) error messages.
  5450.  
  5451.  
  5452. QEdit Error Messages
  5453. ====================
  5454.  
  5455. Can't execute scrap macro when macro recording on:  The ExecuteScrap
  5456. command cannot be used during macro recording.
  5457.  
  5458. Disk full:  A disk full condition was encountered while trying to
  5459. save a file.
  5460. Resolution:  Temporarily exit to DOS using the Shell command and
  5461. remove some files on the full disk, OR use the KillFile command to
  5462. remove the currently edited file from disk, OR use the
  5463. ChangeFilename command to direct the file to a different disk drive
  5464. designation.
  5465.  
  5466. Error creating file:  The filename specified on the command line is
  5467. either an invalid DOS filename or there are no files matching the
  5468. wildcarded specification.
  5469. Resolution:  Enter a valid DOS filename or valid wildcarded
  5470. designation on the command line when executing QEdit.
  5471.  
  5472. Error running program:  DOS returned an error condition when
  5473. QEdit attempted to perform the DOS EXEC function to load and execute
  5474. a program and/or the DOS SHELL.
  5475. Resolution:  Check these possible causes: there is not enough memory
  5476. to load the external program, OR the COMMAND.COM file is not
  5477. available, OR the COMSPEC environment variable is not set properly.
  5478. Refer to your DOS manual for more information on the COMSPEC
  5479. environment variable.
  5480.  
  5481. Error opening file:  The file specified cannot be opened.
  5482. Resolution:  Check for possible disk errors or failure.
  5483.  
  5484. Error reading file:  The file specified cannot be read.
  5485. Resolution:  Check for possible disk errors or failure.
  5486.  
  5487.  C-1
  5488.  
  5489. Error renaming file:  The file specified cannot be renamed.
  5490. Resolution:  Check for possible disk errors or failure.
  5491.  
  5492. Error writing file:  The file specified cannot be saved.
  5493. Resolution:  Check for possible disk errors or failure.
  5494.  
  5495. File not found:  The file specified in response to the MacroRead or
  5496. ReadBlock command could not be found on disk.
  5497. Resolution:  Check for the correct name of the file to read.
  5498.  
  5499. Filename already in use in ring:  The file specified in response to
  5500. the ChangeFilename command is already loaded into the editor.
  5501. Resolution:  Enter a filename that is not already loaded into the
  5502. editor.  If you are attempting to "jump" to another file in the
  5503. ring, use the EditFile command.
  5504.  
  5505. Invalid macro filesize:  An attempt was made to load a macro file
  5506. using the MacroRead command, which is either too large or is not
  5507. a valid macro file.
  5508. Resolution:  Check for the correct name of the macro file to read.
  5509.  
  5510. Key already defined:  An attempt was made to assign a
  5511. macro to a key which already has a command assignment.
  5512. Resolution:  Refer to Appendix B and select a key which does not
  5513. already have a command assignment.
  5514.  
  5515. Long lines split:  An attempt was made to load a file whose line
  5516. length exceeded the QEdit limit of 512 characters.
  5517. Resolution:  The file can still be edited, but be aware that all
  5518. lines exceeding 512 characters will be split into shorter lines.
  5519.  
  5520. Macro table full:  There is no more room to record macros.
  5521. Resolution:  Delete some unused macros.
  5522.  
  5523. Macro too long - Aborted:  The macro being created during macro
  5524. recording has exceeded the maximum length.
  5525. Resolution:  Keep macros to less than 250 consecutive "entries".  
  5526. Note that during macro recording each QEdit command takes up 1 of 
  5527. these entries and each keyboard character takes up 2 entries.
  5528.  
  5529. Match not found:  No match was found for "(", "{", or "[" characters
  5530. when using the Match command.
  5531.  
  5532. Memory lost to sub-process:  A memory-resident program (TSR) was
  5533. executed using the QEdit Dos or Shell command and has procured
  5534. memory that was in use by the editor.
  5535. Resolution:  Immediately SAVE any files you are editing and re-boot
  5536. your system.
  5537.  
  5538.  C-2
  5539.  
  5540. No files found:  An invalid wildcarded filename was entered in
  5541. response to a QEdit "file(s) to edit" prompt.
  5542. Resolution:  Check for the correct filename(s) to edit.
  5543.  
  5544. Not enough memory to load entire file:  There is not enough memory 
  5545. to load the requested file into the editor.
  5546. Resolution:  Split the requested file into separate files.
  5547.  
  5548. Not enough memory:  There is not enough memory to continue editing
  5549. the current file.
  5550. Resolution:  Split the current file into separate files.
  5551.  
  5552. Printer error:  An error was encountered while attempting to direct
  5553. an edit file to the printer.
  5554. Resolution:  Check to see that the printer is powered on, online, 
  5555. and properly connected to the computer.
  5556.  
  5557. Press any key to continue:  The editor has displayed a message and
  5558. will not continue until instructed.
  5559.  
  5560.  
  5561. QCONFIG Error Messages
  5562. ======================
  5563.  
  5564. invalid response - try again:  An invalid parameter was entered in
  5565. response to a configuration option.
  5566. Resolution:  Reread option and enter valid parameter.
  5567.  
  5568. ERROR!!! Help buffer overflow in help.txt at line #:  The Help
  5569. file contains more than 1800 non-blank characters.
  5570. Resolution:  Edit the Help file and reduce the number of non-blank
  5571. characters.
  5572.  
  5573. Help filename xxxxxxxx.xxx NOT found:  The specified name of the 
  5574. Help file can not be found on disk.
  5575. Resolution:  Check for the correct name of the Help file.
  5576.  
  5577. Unexpected End Of File encountered at line #:   There is a problem
  5578. with the format of the Help file - possibly corrupted.
  5579. Resolution:  Load the Help file into QEdit and enter the SaveFile
  5580. command.
  5581.  
  5582. Line # too long:  The specified line in the Help file exceeds the
  5583. maximum length of 80 characters.
  5584. Resolution:  Edit the Help file and ensure that no lines exceed 80
  5585. characters in length.
  5586.  
  5587.  C-3
  5588.  
  5589. FATAL ERROR:  macro too long at line #:  The macro at the specified
  5590. line number in the Keyboard Definition file exceeds the maximum
  5591. length of 255 characters.
  5592. Resolution:  Edit the Keyboard Definition file and ensure that no
  5593. macros exceed 255 characters in length.
  5594.  
  5595. FATAL ERROR:  unrecognized command xxxx at line #:  The Keyboard
  5596. Definition file contains an invalid command at the specified line
  5597. number.
  5598. Resolution:  Edit the Keyboard Definition file and correct the
  5599. invalid command.
  5600.  
  5601. FATAL ERROR:  macro table full at line #:  There is no more room 
  5602. left in the Keyboard Definition file for macros.
  5603. Resolution:  Delete some unused macros.
  5604.  
  5605. FATAL ERROR:  too many twokey definitions, aborted at line #:  The
  5606. maximum number of twokey assignments in the Keyboard Definition file
  5607. has been exceeded.
  5608. Resolution:  Edit the Keyboard Definition file and reduce the number
  5609. of twokey assignments.  Generally, there can be 30 to 50 twokey
  5610. assignments, depending on the number of unique first keys.  The more
  5611. unique first keys there are, the fewer twokey assignments can be
  5612. made.
  5613.  
  5614. FATAL ERROR:  invalid second key code xx at line #:  The Keyboard
  5615. Definition file contains an invalid second key (of a twokey
  5616. assignment) at the specified line number.
  5617. Resolution:  Edit the Keyboard Definition file and correct the
  5618. invalid key.
  5619.  
  5620. FATAL ERROR:  macro_begin not supported for twokey commands, line #:
  5621. Macros cannot be assigned to twokeys.
  5622.  
  5623. FATAL ERROR:  return bound to twokey at line #:  The Return command
  5624. cannot be assigned to a twokey.
  5625.  
  5626. FATAL ERROR:  escape bound to twokey at line #:  The Escape command
  5627. cannot be assigned to a twokey.
  5628.  
  5629. FATAL ERROR:  undefined key xxxx encountered at line #:   The 
  5630. Keyboard Definition file contains an invalid configurable key at the 
  5631. specified line number.
  5632. Resolution:  Edit the Keyboard Definition file and correct the
  5633. invalid key.
  5634.  
  5635. FATAL ERROR:  return command MUST be "bound" to a key:  The Return
  5636. command is not assigned to any key in the Keyboard Definition file.
  5637. Resolution:  Assign the Return command to some configurable key in
  5638. the Keyboard Definition file.
  5639.  
  5640.  C-4
  5641.  
  5642. FATAL ERROR:  escape command MUST be "bound" to a key:  The Escape
  5643. command is not assigned to any key in the Keyboard Definition file.
  5644. Resolution:  Assign the Escape command to some configurable key in
  5645. the Keyboard Definition file.
  5646.  
  5647. File xxxxxxxx.xxx not found:  The specified name of the Keyboard
  5648. Definition file can not be found on disk.
  5649. Resolution:  Check for the correct name of the Keyboard Definition
  5650. file.
  5651.  
  5652. FATAL ERROR:  xxxxxxxx.xxx not found:  The specified name of the
  5653. QEdit executable file cannot be found on disk.
  5654. Resolution: Check for the correct name of the QEdit executable file.
  5655.  
  5656. FATAL ERROR:  patch area NOT found:  There is a problem with the 
  5657. QEdit executable file (Q.EXE or copy of same).
  5658. Resolution:  Reload the QEdit (Q.EXE) and QCONFIG.EXE executable
  5659. files from the QEdit distribution disk.
  5660.  
  5661. FATAL ERROR:  end of patch area NOT found.  There is a problem with
  5662. the QEdit executable file (Q.EXE or copy of same).
  5663. Resolution:  Reload the QEdit (Q.EXE) and QCONFIG.EXE executable
  5664. files from the QEdit distribution disk.
  5665.  
  5666.  
  5667.  C-5
  5668.  
  5669. APPENDIX D.  COMMONLY USED MACROS___________________________________
  5670.  
  5671. We have received many useful suggestions from QEdit users over the
  5672. years.  Since the introduction of macros in version 2.00, we have
  5673. received ideas for some very helpful macros.  Here is a short list
  5674. of some of the more useful (and simple) macros.  (Appendix E
  5675. contains additional sample macros.)
  5676.  
  5677.  
  5678. - By default, QEdit's AddLine and DelLine commands do not change the
  5679.   cursor position.  Many would prefer that the cursor move to column
  5680.   one when these commands are executed.  A solution is to change the
  5681.   QCONFIG.DAT file (and reload using QCONFIG.EXE) as follows:
  5682.  
  5683.   Default QCONFIG.DAT file:
  5684.  
  5685.   f2   AddLine
  5686.   ^y   DelLine
  5687.  
  5688.   Customized QCONFIG.DAT file:
  5689.  
  5690.   f2   MacroBegin AddLine BegLine
  5691.   ^y   MacroBegin DelLine BegLine
  5692.  
  5693.  
  5694. - By default, QEdit's CopyBlock and MoveBlock commands leave the
  5695.   copied or moved block marked.  Many would prefer for the block to
  5696.   be unmarked.  A solution is to change the QCONFIG.DAT file (and
  5697.   reload using QCONFIG.EXE) as follows:
  5698.  
  5699.   Default QCONFIG.DAT file:
  5700.  
  5701.   @c   CopyBlock
  5702.   @m   MoveBlock
  5703.  
  5704.   Customized QCONFIG.DAT file:
  5705.  
  5706.   @c   MacroBegin CopyBlock UnmarkBlock
  5707.   @m   MacroBegin MoveBlock UnmarkBlock
  5708.  
  5709.  
  5710.  D-1
  5711.  
  5712. - By default, QEdit's ReadBlock command inserts a file from disk at
  5713.   the current cursor position.  To have QEdit insert files on the
  5714.   line immediately following the current cursor line, change the
  5715.   QCONFIG.DAT file (and reload using QCONFIG.EXE) as follows:
  5716.  
  5717.   Default QCONFIG.DAT file:
  5718.  
  5719.   @r   ReadBlock
  5720.  
  5721.   Customized QCONFIG.DAT file:
  5722.  
  5723.   @r   MacroBegin EndLine SplitLine CursorDown BegLine ReadBlock
  5724.        GotoBlockEnd JoinLine GotoBlockBeg
  5725.  
  5726.  
  5727. - By default, QEdit's DropAnchor command will end or extend a block 
  5728.   if executed after a Block has been initially or entirely marked. 
  5729.   Some editors have a similar command, except that it acts as a 
  5730.   toggle.  That is, if you are already marking a Block, and you 
  5731.   press DropAnchor again, the Block is unmarked and marking begins 
  5732.   again at the current cursor position.  To implement, change the 
  5733.   QCONFIG.DAT file (and reload using QCONFIG.EXE) as follows:
  5734.  
  5735.   Default QCONFIG.DAT file:
  5736.  
  5737.   @a   DropAnchor
  5738.  
  5739.   Customized QCONFIG.DAT file:
  5740.  
  5741.   @a   MacroBegin UnmarkBlock DropAnchor
  5742.  
  5743.  
  5744. - A very useful QEdit command, GetPrev, will copy a character from
  5745.   the line immediately above the cursor line, onto the cursor line.
  5746.   Many times, it may be necessary to copy this character to several
  5747.   succeeding lines in the same column.  The GetPrev command, used in
  5748.   a macro, makes this function easy.  We will assign the macro to
  5749.   the <Alt 1> key (@1 in QEdit's terminology).
  5750.  
  5751.   @1   MacroBegin GetPrev CursorLeft CursorDown
  5752.  
  5753.  
  5754. - This macro will allow you to edit a sorted list of files of the
  5755.   current directory.
  5756.  
  5757.   @1   MacroBegin Dos "dir *.* | sort>filedir.tmp" Return Return
  5758.        EditFile "filedir.tmp" Return DelLine DelLine DelLine DelLine
  5759.  
  5760.  D-2
  5761.  
  5762. APPENDIX E.  ADDENDUM_________________________________
  5763.  
  5764. Contents
  5765. ========
  5766.  
  5767. About this Addendum and Version 2.1 ............. E-2
  5768. Upgrading from QEdit Version 2.07 or Later ...... E-3
  5769. Upgrading from QEdit Version 2.06 or Earlier .... E-4
  5770. New QEdit Commands .............................. E-5
  5771. QEdit Changes
  5772.    Macro Pause .................................. E-8
  5773.    Startup Macros ............................... E-9
  5774.    Save-As-Filename ............................. E-10
  5775.    Read-Only Files  ............................. E-10
  5776.    Invoking QEdit at a Specific Line Number ..... E-11
  5777.    Dos and Shell Commands:
  5778.      Swapping, [QE] Shell Indicator ............. E-11
  5779.    Find, FindReplace Commands:
  5780.      Local and Global Options ................... E-12
  5781.    Conditional Logic for Macros:
  5782.      Jump, JTrue, JFalse Commands ............... E-12
  5783. Configuration Program (QCONFIG) Changes ......... E-13
  5784. New Macros ...................................... E-14
  5785.  
  5786.  
  5787.  E-1
  5788.  
  5789. About this Addendum and Version 2.1
  5790. ===================================
  5791. This addendum documents all new features and changes since version
  5792. 2.07 of QEdit.  The following is a quick summary of the new features
  5793. and changes. Many of these are explained in more detail in this
  5794. addendum.
  5795.  
  5796. Especially for programmers we've added:
  5797.  
  5798.  - swapping to disk or expanded memory to free up memory for
  5799.    compiles when the DOS shell commands are executed (ToggleSwap
  5800.    command, default configuration option)
  5801.  
  5802.  - the ability to shift entire blocks using the tab left and right
  5803.    commands (TabLt and TabRt)
  5804.  
  5805.  - additional C mode file extensions (.cpp, .cxx, .hpp, .hxx)
  5806.  
  5807.  - a "sticky" AutoIndent configuration option
  5808.  
  5809.  - the availability of the CurrentFilename command at anytime
  5810.  
  5811.  - a DOS command line option (-n) for jumping to a specific line
  5812.    number
  5813.  
  5814. Especially for writers and nonprogrammers we've added:
  5815.  
  5816.  - case-change (Flip, Lower, Upper commands)
  5817.  
  5818.  - multiple line-drawing characters (ToggleBoxType command)
  5819.  
  5820.  - top and bottom margins for printing (SetPrintBotMargin,
  5821.    SetPrintTopMargin commands)
  5822.  
  5823.  - line-centering (CenterLine command)
  5824.  
  5825.  - block-fill (FillBlock command)
  5826.  
  5827. Especially for laptop users we've added:
  5828.  
  5829.  - an optional large flashing block cursor (configuration option)
  5830.  
  5831. Especially for macro users we've added:
  5832.  
  5833.  - the ability to load and/or execute macros from the DOS command
  5834.    line
  5835.  
  5836.  - macro pause (Pause command)
  5837.  
  5838.  - macro repeat (RepeatCmd command)
  5839.  
  5840.  - conditional logic (Jump, JTrue, JFalse commands)
  5841.  
  5842.  E-2
  5843.  
  5844. For everybody we've added:
  5845.  
  5846.  - sorting (Sort command)
  5847.  
  5848.  - column block copy, move, delete, and print
  5849.  
  5850.  - a "save-as-filename" feature with an option to append
  5851.  
  5852.  - the ability to both increase and decrease the size of a window
  5853.    using either of the window sizing commands (GrowWindow and
  5854.    ShrinkWindow)
  5855.  
  5856.  - the availability of the Paste command within prompt boxes
  5857.  
  5858.  - new options for the Find and FindReplace commands to start a 
  5859.    search at the beginning of your file (g option) and limit a 
  5860.    search to a marked block (l option)
  5861.  
  5862.  - the ability to cancel global search and replace and the new
  5863.    RepeatCmd by pressing <Ctrl Break>
  5864.  
  5865.  - an optional bell that sounds on warning messages & missed searches
  5866.  
  5867.  - editing of Read-Only files
  5868.  
  5869.  - Pop-Down style boxes for all "Yes/No" prompts
  5870.  
  5871.  - the saving of all deleted characters to the Kill Buffer when
  5872.    using the DelRtWord command
  5873.  
  5874.  - the ability to search more than one line backward for a nonblank
  5875.    line in Smart Tabs mode
  5876.  
  5877.  
  5878. Upgrading from QEdit Version 2.07 or Later
  5879. ==========================================
  5880. If you are upgrading QEdit version 2.1 from version 2.07 or later
  5881. and you do not care to retain any changes you have made using the
  5882. configuration program (QCONFIG), then simply refer to the
  5883. "Installation" section for installation instructions.
  5884.  
  5885. If you wish to upgrade while retaining your configuration changes
  5886. then do the following:
  5887.  
  5888.   1. Copy the QCONFIG.DAT that you currently use to a floppy disk
  5889.      or some other safe location.
  5890.  
  5891.   2. Make a backup copy of your QEdit version 2.1 distribution
  5892.      diskette and file the original away in a safe location.
  5893.  
  5894.   3. Insert the copy of the distribution diskette (from step 2)
  5895.      into a floppy drive and execute the Update Program by
  5896.      entering "<drive designation>:qupdate"
  5897.  E-3
  5898.  
  5899.   4. Enter responses to the Update Program prompts as they appear.
  5900.  
  5901.   5. Upon successful completion the Update Program will display
  5902.      "QEdit Advanced updated successfully."
  5903.  
  5904.   6. Copy the QEdit version 2.1 software from the floppy diskette
  5905.      to the directory that you use to run QEdit. For example:
  5906.          Copy a:*.* \tools
  5907.  
  5908.   7. Copy your QCONFIG.DAT file from step 1 to the directory that
  5909.      you use to run QEdit.  This should be the same directory to
  5910.      which you copied the files in step 6.
  5911.  
  5912.   8. Edit and add to the QCONFIG.DAT file (using QEdit of course)
  5913.      any new QEdit commands added since the version you were using.
  5914.      Refer to the "New QEdit Commands" section of Appendix E for a
  5915.      complete list of new commands.  Now run QCONFIG to install
  5916.      these new commands.  For more information on the QCONFIG.DAT
  5917.      file and running QCONFIG please refer to Chapter 2.
  5918.  
  5919.  
  5920. Upgrading from QEdit Version 2.06 or Earlier
  5921. ============================================
  5922. If you are upgrading QEdit version 2.1 from version 2.06 or earlier
  5923. and you do not care to retain any changes you have made using the
  5924. configuration program (QCONFIG), then simply refer to the
  5925. "Installation" section for installation instructions.
  5926.  
  5927. The only configuration changes that can be retained from version
  5928. 2.06 or earlier are the key assignments made in the QCONFIG.DAT
  5929. file. If you wish to upgrade while retaining these changes then do
  5930. the following:
  5931.  
  5932.   1. Copy the QCONFIG.DAT that you currently use to a floppy disk
  5933.      or some other safe location.
  5934.  
  5935.   2. Make a backup copy of your QEdit version 2.1 distribution
  5936.      diskette and file the original away in a safe location.
  5937.  
  5938.   3. Copy the QEdit version 2.1 software from the floppy diskette
  5939.      from step 2 to the directory that you use to run QEdit.  For
  5940.      example:  Copy a:*.* \tools
  5941.  
  5942.   4. Copy your QCONFIG.DAT file from step 1 to the directory that
  5943.      you use to run QEdit.  This should be the same directory to
  5944.      which you copied the files in step 3.
  5945.  
  5946.   5. Edit and add to the QCONFIG.DAT file (using QEdit of course)
  5947.      any new QEdit commands added since the version you were using.
  5948.      Refer to the "New QEdit Commands" section of Appendix E for a
  5949.      complete list of new commands.  Now run QCONFIG to install
  5950.      these new commands.  For more information on the QCONFIG.DAT
  5951.      file and running QCONFIG please refer to Chapter 2.
  5952.  E-4
  5953.  
  5954. New QEdit Commands
  5955. ==================
  5956. This section contains a description of each of the new QEdit 
  5957. commands. Where appropriate, the default key assignments are 
  5958. provided.  To assign commands which do not have a default assignment 
  5959. or to change existing key assignments, refer to the "Keyboard 
  5960. Configuration" section of Chapter 2 for instructions.
  5961.  
  5962.  
  5963. AltWordSet
  5964. ----------------------------------------
  5965. Instructs QEdit to recognize an expanded set of characters as "word"
  5966. characters.
  5967.  
  5968. The default word set contains the following characters: 0 through 9,
  5969. upper and lower case A through Z, and the underline character.  The
  5970. AltWordSet command causes additional characters to be considered
  5971. "word" characters.  These additional characters are:  ! # $ % & ` '
  5972. ( ) - . / \ @ { } ~ : ^
  5973.  
  5974. The AltWordSet command will affect the operation of these commands:
  5975.       DelLtWord  <Ctrl Backspace>
  5976.       DelRtWord  <Ctrl T>
  5977.       MarkWord   <Ctrl KT>
  5978.       WordLeft   <Ctrl Cursor Left>
  5979.       WordRight  <Ctrl Cursor Right>
  5980.  
  5981. The default word set can be re-installed by executing the
  5982. DefaultWordSet command.
  5983.  
  5984.  
  5985. CenterLine          <Ctrl OT>
  5986. ----------------------------------------
  5987. Centers the current cursor line based on column 1 and the right
  5988. margin.  Use the SetRmargin <Ctrl OR> command to change the right
  5989. margin.
  5990.  
  5991. With the cursor inside of a line block, you can execute this command
  5992. to center several lines at once.  With the cursor inside of a column
  5993. block, you can center lines based on the left and right block
  5994. boundaries.
  5995.  
  5996.  
  5997. DefaultWordSet
  5998. ----------------------------------------
  5999. Re-installs the default word set.  Refer to the AltWordSet command
  6000. for more information about word sets.
  6001.  
  6002.  
  6003. EndPara
  6004. ----------------------------------------
  6005. Positions the cursor immediately following the last nonblank
  6006. character of the current paragraph.
  6007.  E-5
  6008.  
  6009. FillBlock           <Ctrl KL>
  6010. ----------------------------------------
  6011. Fills an entire marked block with any ASCII character.  You will be
  6012. prompted to enter the desired character.  FillBlock is recommended
  6013. for use with column and word blocks only because it will fill other
  6014. type blocks with characters beyond column 80.
  6015.  
  6016. Flip                <Alt 3>
  6017. ----------------------------------------
  6018. Reverses the case (upper to lower and lower to upper) of all
  6019. characters in a marked block.  The cursor must be within the marked
  6020. block.  If the cursor is outside of the marked block or if no block
  6021. is marked, the case of the character at the current cursor position
  6022. is reversed.
  6023.  
  6024.  
  6025. GotoColumn
  6026. ----------------------------------------
  6027. Positions the cursor at the requested column.  The editor will 
  6028. prompt for the desired column number.
  6029.  
  6030. Lower               <Alt 2>
  6031. ----------------------------------------
  6032. Changes all characters in a marked block to lower case.  The cursor
  6033. must be within the marked block.  If the cursor is outside of the
  6034. marked block or if no block is marked, the character at the current
  6035. cursor position is changed to lower case.
  6036.  
  6037.  
  6038. MarkWord            <Ctrl KT>
  6039. ----------------------------------------
  6040. This command is used to mark a word block.  Executing this command
  6041. will mark the word at the current cursor position.  If there is no
  6042. word at the current cursor position, then no action is taken.
  6043.  
  6044. NewFile
  6045. ----------------------------------------
  6046. Executes the Exit <Ctrl KD> command followed by the EditFile <Alt E>
  6047. command.  Refer to Chapter 3 for more information regarding the Exit
  6048. and EditFile commands.
  6049.  
  6050.  
  6051. NextPara
  6052. ----------------------------------------
  6053. Positions the cursor on the first character of the next paragraph.
  6054.  
  6055.  
  6056. Pause
  6057. ----------------------------------------
  6058. Temporarily suspends execution of a macro until either <Enter> or
  6059. <Escape> is pressed.  Refer to the "QEdit Changes" section of
  6060. Appendix E for more information.
  6061.  
  6062.  E-6
  6063.  
  6064. PrevPara
  6065. ----------------------------------------
  6066. Positions the cursor on the first character of the previous 
  6067. paragraph.
  6068.  
  6069.  
  6070. RepeatCmd           <Ctrl QQ>
  6071. ----------------------------------------
  6072. Repeats the last character, command, or macro entered from the
  6073. keyboard up to 9,999 times.  You will be prompted for the number of
  6074. times to repeat.
  6075.  
  6076. Repeating will automatically terminate if any command fails.  For
  6077. example, if you are repeating a search and get a "Not Found" then
  6078. repeating will stop.  Also, you can enter <Ctrl Break> at anytime
  6079. from the keyboard to cancel repeating.
  6080.  
  6081. RepeatCmd is very handy for use within macros in the QCONFIG.DAT 
  6082. file. For example, to cursor down 10 times within a macro you would 
  6083. enter: "CursorDown 10" (without the quotes). For more information on 
  6084. macros refer to the "Keyboard Configuration" section of Chapter 2.
  6085.  
  6086.  
  6087. SetPrintBotMargin   <Alt P><O> or <Esc><P><O>
  6088. ----------------------------------------
  6089. Sets the number of lines that will be left blank at the bottom of
  6090. each page during printing.
  6091.  
  6092.  
  6093. SetPrintTopMargin   <Alt P><T> or <Esc><P><T>
  6094. ----------------------------------------
  6095. Sets the number of lines that will be left blank at the top of each
  6096. page during printing.
  6097.  
  6098.  
  6099. Sort                <Shift F3>
  6100. ----------------------------------------
  6101. Sorts a range of lines in ascending order.  The sort key is
  6102. determined by a marked column block.  The length of the column block
  6103. determines the range of lines to be sorted.  For more information
  6104. about column blocks refer to the MarkColumn command in chapter 3.
  6105.  
  6106. This command can only be used with a single, nonzoomed window on the
  6107. screen.
  6108.  
  6109.  
  6110. ToggleBoxType       <Alt F1>
  6111. ----------------------------------------
  6112. This command prompts the User to select from different line drawing
  6113. styles for use with Box Drawing mode.  The options are: Single,
  6114. Double Top, Double Side, Double, and Eraser.
  6115.  
  6116.  E-7
  6117.  
  6118. ToggleSwap          <Esc><O><S>
  6119. ----------------------------------------
  6120. Toggles (ON and OFF) swapping to expanded memory or disk when the
  6121. Shell <F9> and Dos <Alt F9> commands are executed.  (You can specify
  6122. a default for swapping using the configuration program.  Refer to
  6123. the "Configuration Program (QCONFIG) Changes" section of Appendix E
  6124. for more information.)
  6125.  
  6126. If ON, QEdit will swap itself out of DOS memory and to expanded
  6127. memory or disk when a shell command is executed.  This will leave a
  6128. small 2K kernel of QEdit in DOS memory, freeing up the rest of DOS
  6129. memory for running other applications out of the shell such as
  6130. compilers or spreadsheets.
  6131.  
  6132. While you are in a shell, QEdit will maintain a file with a ".SWP"
  6133. file extension in your root directory.  It is very important that
  6134. you do not delete this file while in the shell.
  6135.  
  6136.  
  6137. Upper               <Alt 1>
  6138. ----------------------------------------
  6139. Changes all characters in a marked block to upper case.  The cursor
  6140. must be within the marked block.  If the cursor is outside of the
  6141. marked block or if no block is marked, the character at the current
  6142. cursor position is changed to upper case.
  6143.  
  6144.  
  6145. QEdit Changes
  6146. =============
  6147. This section contains new QEdit features and changes which require a
  6148. detailed explanation.  For a summary of all new features and changes
  6149. refer to the "About this Addendum and Version 2.1" section of
  6150. Appendix E.
  6151.  
  6152.  
  6153. Macro Pause
  6154. -----------
  6155. A new command, Pause, has been added for use within macros.  The
  6156. Pause command allows you to suspend execution of a macro, make
  6157. entries from the keyboard, and then continue execution of the macro.
  6158.  
  6159. To use the Pause command you place "Pause" at the appropriate
  6160. position within a macro in the QCONFIG.DAT file.  (For more
  6161. information about creating macros refer to the "Keyboard
  6162. Configuration" section of Chapter 2.)
  6163.  
  6164. When you execute a macro containing a Pause command from within
  6165. QEdit, its execution will be suspended when the Pause command is
  6166. encountered. A "P" will appear on the Status Line.  At this point
  6167. the User can enter text from the keyboard.  Pressing <Enter> will
  6168. resume execution of the macro.  Pressing <Escape> will terminate
  6169. execution of the suspended macro entirely.
  6170.  
  6171.  E-8
  6172.  
  6173. Please note that the <Enter> entered from the keyboard to resume
  6174. execution of a suspended macro is "eaten" by the Pause command; or,
  6175. in other words, the <Enter> does not become part of the macro.
  6176.  
  6177. Some examples of using the Pause command within macros can be found
  6178. in the "New Macros" section of Appendix E.
  6179.  
  6180.  
  6181. Startup Macros
  6182. --------------
  6183. QEdit has a new feature which allows you to load and/or execute
  6184. macros from the DOS command line.  Previously, any macro created
  6185. within QEdit and saved using the MacroWrite <Esc><M><W> command had
  6186. to be manually reloaded using the MacroRead <Esc><M><R> command for
  6187. each new editing session. (You may want to review the "Macros"
  6188. section of Chapter 1 before proceeding.)
  6189.  
  6190. To load a macro from the DOS command line type "-l" (this is a dash
  6191. character and the letter "l") followed by a macro filename when you
  6192. execute QEdit.  For example, from the DOS prompt type:
  6193.  
  6194.     q <filename to edit> -l<macro filename>
  6195.  
  6196. To execute a macro from the DOS command line type "-e" followed by a
  6197. macro filename when you execute QEdit.  It will automatically
  6198. execute the first macro in the macro file after the file to be
  6199. edited has been loaded.  For example, from the DOS prompt type:
  6200.  
  6201.     q <filename to edit> -e<macro filename>
  6202.  
  6203. Here are some additional notes regarding the use of Startup Macros.
  6204.  
  6205. - The macro file to be loaded and/or executed must be created using
  6206.   the MacroWrite <Esc><M><W> command.
  6207.  
  6208. - A "/" character can be used instead of the "-" character, as in
  6209.   "/l" and "/e".
  6210.  
  6211. - You must supply a filename to be edited on the DOS command line to
  6212.   use this feature.
  6213.  
  6214. - When using the execute ("-e") option, only the first macro in the
  6215.   macrofile is executed.  Also, the macro is executed only after the
  6216.   file to be edited has been loaded.
  6217.  
  6218. - You can both load and execute a macro at the same time. For 
  6219.   example, from the DOS prompt:
  6220.  
  6221.    q <edit filename> -e<macro filename> -l<macro filename>
  6222.  
  6223.  E-9
  6224.  
  6225. Here is an example of using Startup Macros.
  6226.  
  6227. Suppose you have two macro files created using the MacroWrite
  6228. <Esc><M><W> command.  The macro files are called first.mac and
  6229. second.mac.
  6230.  
  6231. Now suppose you want to edit a file called work.tmp and at the same
  6232. time, from the DOS command line, load the macro file called
  6233. first.mac and execute the macro file called second.mac.  Then from
  6234. the DOS command line you would enter:
  6235.  
  6236.     q work.tmp -lfirst.mac -esecond.mac
  6237.  
  6238.  
  6239. Save-As-Filename
  6240. ----------------
  6241. A new feature allows you to save your current file under a different
  6242. name.  To do so, execute the WriteBlock <Alt W> command with no
  6243. marked blocks in the file.  QEdit will prompt with:
  6244.   +----------------------------------------------+
  6245.   |File to write:                                |
  6246.   |                                              |
  6247.   +----------------------------------------------+
  6248.  
  6249. Enter the new filename.  If the filename you specify already exists,
  6250. QEdit will prompt with:
  6251.                         +======= Choose ========+
  6252.                         | Overlay existing file |
  6253.                         | Append to file        |
  6254.                         +=======================+
  6255.  
  6256. Select the option you desire or press Escape to abort.
  6257.  
  6258. If there is a marked block in the file, the WriteBlock command will,
  6259. as before, write the currently marked block to the named file.
  6260.  
  6261.  
  6262. Read-Only Files
  6263. ---------------
  6264. Read-Only files can now be loaded and edited.  However, they cannot
  6265. be saved.  If you attempt to save a Read-Only file the following
  6266. message will appear:
  6267.       +============================================+
  6268.       |File is marked as READONLY - Press <Esc>    |
  6269.       +============================================+
  6270.  
  6271. This message will also appear when you initially load the file.
  6272.  
  6273. To save a Read-Only file, simply save it under a different name
  6274. using the WriteBlock <Alt W> command (be sure there are no marked
  6275. blocks in the file), or change the filename using the ChangeFilename
  6276. <Alt O> command and then save the file under the new name.
  6277.  
  6278.  E-10
  6279.  
  6280. Invoking QEdit at a Specific Line Number
  6281. ----------------------------------------
  6282. A new DOS command line option (-n) allows you to specify a line
  6283. number in a file on which to position the cursor when the file is
  6284. loaded into QEdit. From the DOS prompt type:
  6285.  
  6286.     q <filename to edit> -n<specific line number>
  6287.  
  6288. For example, to load file1 at line number 125, from the DOS command
  6289. line you would enter:
  6290.  
  6291.     q file1 -n125
  6292.  
  6293.  
  6294. Dos and Shell Commands:  Swapping, [QE] Shell Indicator
  6295. -------------------------------------------------------
  6296. The QEdit Dos and Shell commands can now optionally swap QEdit out
  6297. to disk or expanded memory leaving only a 2k kernel in memory.  This
  6298. allows much more memory for running memory-hungry programs (such as
  6299. compilers) from within QEdit. You can set this option by default
  6300. using the configuration program (Advanced Options), or you can
  6301. toggle it on and off using the ToggleSwap command.  (Refer to the
  6302. "Configuration Program (QCONFIG) Changes" section of Appendix E, and
  6303. to the ToggleSwap command under the "New QEdit Advanced Commands"
  6304. section of Appendix E.)
  6305.  
  6306. While in a shell with swapping on, QEdit will maintain a file with a
  6307. ".SWP" file extension in your root directory.  It is very important
  6308. that you do not delete this file while in the shell.
  6309.  
  6310.  
  6311. Once in the shell, QEdit will optionally append "[QE]" to the DOS
  6312. prompt string, provided that:
  6313.  
  6314.   1) You have defined the prompt environment variable.
  6315.   2) There is enough space left in the environment.
  6316.   3) You have set the "Change DOS PROMPT during a Shell" option to
  6317.      [Y]es.  (Refer to Advanced Options of the "Configuration
  6318.      Program (QCONFIG) Changes" section of Appendix E.)
  6319.  
  6320. If you have NOT defined the prompt environment variable, then we
  6321. suggest you do so.  It is helpful with DOS command line operations
  6322. in general.  A suggested prompt is (this should go in your
  6323. AUTOEXEC.BAT file):
  6324.  
  6325.     set prompt=$p $t $g
  6326.  
  6327. If you do have a prompt string defined, but you do not get the 
  6328. "[QE]" prompt in the QEdit shell, add the following to your 
  6329. AUTOEXEC.BAT:
  6330.  
  6331.     set x=x
  6332.  
  6333.  E-11
  6334.  
  6335. Find, FindReplace Commands:  Local and Global Options
  6336. -----------------------------------------------------
  6337. Two options, local and global, have been added to the Find and
  6338. FindReplace commands:
  6339.  
  6340.   [G] = Global search.  Begins searching from the beginning of the
  6341.         file, or from the beginning of the marked block if the [L]
  6342.         option is also selected.
  6343.  
  6344.   [L] = Local search.  Limits the search to the currently marked
  6345.         block.  If the cursor is outside the marked block, or the
  6346.         [G] option is also selected, the search starts at the
  6347.         beginning of the marked block.  Otherwise, the search starts
  6348.         at the current cursor position inside the marked block.
  6349.  
  6350. You can press <Ctrl Break> to halt a global FindReplace.
  6351.  
  6352.  
  6353. Conditional Logic for Macros:  Jump, JTrue, JFalse Commands
  6354. -----------------------------------------------------------
  6355. Three commands have been added for use within QEdit macros:  Jump,
  6356. JTrue, and JFalse.  Placement of one of these commands following
  6357. another QEdit command in a macro allows for branching or looping
  6358. during macro execution.
  6359.  
  6360. All QEdit commands set an internal QEdit result code of "true" upon
  6361. successful execution, or "false" if execution is unsuccessful or no
  6362. action occurs. The Jump command makes an unconditional jump.  The
  6363. JTrue command makes a jump only when a result code of "true" is
  6364. returned; JFalse makes a jump only for a result code of "false".
  6365.  
  6366.  
  6367. Labels can be defined for branching, in the format "label:".  The
  6368. maximum label length is 15 characters.
  6369.  
  6370.  
  6371. For example, here is a macro to delete from the cursor position to
  6372. the beginning of the line, assigned to the f10 key:
  6373.  
  6374.      f10 MacroBegin
  6375.          begin:
  6376.            CursorLeft
  6377.            JFalse done:
  6378.            DelCh
  6379.            Jump begin:
  6380.          done:
  6381.  
  6382. NOTE:  As with all macros, this MUST all occur on ONE LINE in your
  6383.        QCONFIG.DAT file.
  6384.  
  6385.  E-12
  6386.  
  6387. Configuration Program (QCONFIG) Changes
  6388. =======================================
  6389. This section contains a list of new options which have been added to 
  6390. the configuration program (QCONFIG). The configuration program 
  6391. prompt, the default value, and a description are given for each 
  6392. option.
  6393.  
  6394. Under Advanced Options:
  6395.  
  6396. - Swap to Expanded memory or DISK on Dos and Shell commands (Y/N)?[Y]:
  6397.     Select <Y> if you want QEdit to swap itself out of DOS memory 
  6398.     and to expanded memory or disk whenever the shell commands are 
  6399.     executed.  This will leave a small 2K kernel of QEdit in DOS 
  6400.     memory, freeing up the rest of DOS memory for running other 
  6401.     applications out of the shell such as compilers or spreadsheets.
  6402.  
  6403. - Drive for disk swapping on the Dos/Shell commands [A..Z] [C] :
  6404.     If you selected <Y> for the previous option then specify here 
  6405.     the disk drive designation to be used for swapping.  Enter an 
  6406.     asterisk (*) if you want QEdit to default to your current drive 
  6407.     for swapping.
  6408.  
  6409. - Do you want a large flashing cursor (Y/N)? [N] :
  6410.     If you want to use a large flashing block cursor then set this
  6411.     option to <Y>.  This option is great for laptop users.
  6412.  
  6413. - Get num rows on screen from BIOS data area (100% IBM PC only)
  6414.   (Y/N)? [N] :
  6415.     FOR NON EGA/VGA SYSTEMS ONLY; set this option to <Y> if you want
  6416.     QEdit to automatically detect the number of rows on your screen.
  6417.  
  6418.     Setting this option to <Y>, to automatically detect the number 
  6419.     of rows on your screen, only works if you have an IBM PC-AT or 
  6420.     100% compatible.  For example, setting this option to <Y> does 
  6421.     NOT work on AT&T 6300's.
  6422.  
  6423. - Number of rows on screen (NOT NEEDED with EGA/VGA) [25..255] [25]:
  6424.     FOR NON EGA/VGA SYSTEMS ONLY; if you set the previous option to
  6425.     <N>, then you must provide the number of rows on your screen here.
  6426.  
  6427.     You should set this option to 25 unless you have a special card
  6428.     and monitor (such as a Genius Video System) that allow you to
  6429.     display more than 25 rows.
  6430.  
  6431. - Should the editor restore the starting drive/dir on program exit
  6432.   (Y/N)? [Y] :
  6433.     Set this option to <Y> if you want to return to the original DOS 
  6434.     drive and directory on program exit regardless of which drives 
  6435.     and directories you have accessed with the QEdit directory 
  6436.     picker or Shell command.
  6437.  
  6438. - Should the editor change the DOS PROMPT during a shell (Y/N)? [N]:
  6439.     Set this option to <Y> if you want the following to be appended 
  6440.     to the DOS prompt during a QEdit Shell: [QE]
  6441.  E-13
  6442.  
  6443. - Should [TabRt]/[TabLt] be allowed to shift an entire block (Y/N)?
  6444.   [N] :
  6445.     Set this option to <Y> if you want the TabRt and TabLt commands 
  6446.     to shift entire marked blocks when the cursor is within the 
  6447.     marked block.
  6448.  
  6449. The following Advanced Option has been deleted:
  6450.  
  6451.     "Do you want to invoke the editor at a specified line number"
  6452.     has been replaced with the "-n" DOS command-line option.
  6453.  
  6454.  
  6455. Under General Options:
  6456.  
  6457. - Do you want the editor to use "sticky" AutoIndent (Y/N)? [N] :
  6458.     If you want QEdit to search more than one line backward for a
  6459.     nonblank line to use for autoindenting, then set this option to
  6460.     <Y>.  AutoIndent mode must be set ON for this option to work.
  6461.     Refer to the "Modes" section of Chapter 1 for more information 
  6462.     on AutoIndent mode.
  6463.  
  6464. - Do you want a beep on warning messages and missed searches (Y/N)?
  6465.   [N] :
  6466.   Select <Y> if you want the bell to sound on any QEdit warning
  6467.   message and whenever there is no match resulting from a Find or
  6468.   FindReplace command.
  6469.  
  6470.  
  6471. Under Printer Options:
  6472.  
  6473. - Default top margin for printing [0..100] :
  6474.     This is the number of lines that will be left blank at the top 
  6475.     of each page during printing.
  6476.  
  6477. - Default bottom margin for printing [0..100] :
  6478.     This is the number of lines that will be left blank at the 
  6479.     bottom of each page during printing.
  6480.  
  6481.  
  6482. New Macros
  6483. ==========
  6484. New features added since version 2.07, such as the Pause command and
  6485. the ability to use the Paste command inside dialogue boxes, make
  6486. several new and interesting macros possible.  The following are some
  6487. sample macros, utilizing these new features, which you might find
  6488. useful.
  6489.  
  6490. The macros in this section can be assigned to any key you desire in
  6491. the Keyboard Definition file.  For more information about creating
  6492. macros refer to the "Keyboard Configuration" section of Chapter 2.
  6493.  
  6494.  E-14
  6495.  
  6496. - For example, suppose you wanted to create a "find" command that
  6497.   always searched forward, ignored case, and didn't prompt you for
  6498.   options.  In the QCONFIG.DAT file, assign to whatever key you like
  6499.   (f7 in this example):
  6500.  
  6501.   f7 MacroBegin Find Pause Return 'i' Return
  6502.  
  6503.   If you wanted to get really fancy, you could let <f7> be your
  6504.   find-forward, and <shift f7> be your find-backward:
  6505.  
  6506.   #f7 MacroBegin Find Pause Return 'ib' Return
  6507.  
  6508. - A macro to take the filename at the current cursor position and 
  6509.   load that file into the editor (In QEdit this macro has been 
  6510.   assigned by default to <Ctrl ]>.):
  6511.  
  6512.   MacroBegin AltWordSet MarkWord Copy EditFile Paste Return
  6513.              DefaultWordSet
  6514.  
  6515.   This macro does the following:
  6516.  
  6517.   AltWordSet     - sets the proper word set for filenames
  6518.   MarkWord       - marks the filename at the current cursor position
  6519.   Copy           - copies the filename into the scrap buffer
  6520.   EditFile       - initiates the EditFile command
  6521.   Paste          - inserts the copied filename into the prompt box
  6522.   Return         - terminates the EditFile prompt
  6523.   DefaultWordSet - restores the normal word set
  6524.  
  6525. - A macro to initiate a Find on the word at the current cursor
  6526.   position (In QEdit this macro has been assigned by default to
  6527.   <Alt =>.):
  6528.  
  6529.   MacroBegin MarkWord Copy Find Paste Return Return
  6530.  
  6531.   This macro does the following:
  6532.  
  6533.   MarkWord       - marks the word at the current cursor position
  6534.   Copy           - copies the word into the scrap buffer
  6535.   Find           - initiates the Find command
  6536.   Paste          - inserts the copied word into the prompt box
  6537.   Return         - terminates the search string prompt box
  6538.   Return         - terminates the Find options prompt box
  6539.  
  6540.  E-15
  6541.